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Introduction 



SuperKey is a keyboard enhancer that makes your keyboard a more efficient tool 
and saves you a lot of time. But SuperKey is much more than that. At the touch 
of a key it gives you instant access to a wealth of useful features found in no other 
single program: 

• You can record sequences of characters in any key (a macro). A single key can 
thus hold lengthy commands for your spreadsheet, w^ord processor, communi- 
cations package, or any other program. One key can store frequently used 
numbers or phrases, or even hold entire paragraphs of text. This will save you 
thousands of keystrokes, because once recorded in a key, all this can be 
"played back" as often as you like at the touch of that single key. And you can 
record in as many keys as you want. 

• SuperKey lets you "cut and paste" data from one program to another, bringing 
integration to "stand-alone" programs such as WordStar, MultiPlan, and many 
more. 

• You can encrypt (scramble) any file for complete data and program security — 
even when you transmit files through the telephone line. 

• You can design your own help systems for any of your programs with Super- 
Key's display macros. 

• You can redefine the layout of your keyboard. The standard keyboard can thus 
be made into a Dvorak keyboard, a Selectric keyboard, or any other keyboard 
of your choice. 



SuperKey gives you loads of "extras," such as a screen-protect option which 
automatically turns off your screen after a preset time (to prevent "burn in" 
screen damage); a 128-character "type-ahead" keyboard buffer; a "command 
stack," which lets you repeat your last 10 to 30 DOS commands without having 
to type them all over again; a "one-finger" mode which changes commands 
normally requiring you to press two or more keys simultaneously into a 
sequence of single keystrokes; and much, much more. 



How to Use SuperKey 



Although SuperKey is simple to use, and gives you detailed help information 
whenever you press |F1 I . we suggest that you at least read Chapters 1, 2, 4, and 
5, which take you on a quick tour of SuperKey and contain a number of useful 
hints. 

These chapters provide a quick-and-easy introduction to SuperKey, but do not 
attempt to discuss it in every detail. Precise descriptions of all SuperKey com- 
mands, features, and concepts, along with examples, are collected alphabetically 
in Chapter 7. Use this chapter as a quick reference guide when you start explor- 
ing SuperKey on your own. 



Structure of this Manual 



• Chapter 1 tells you how to get SuperKey up and running. Also, all the files on 
your distribution disk are described here. 

• Chapter 2 steps you through a typical session with SuperKey: making, saving, 
loading and deleting a macro; encrypting and decrypting a file; and using the 
SuperKey menus. 

• Chapter 3 shows you how to sidestep the SuperKey menus and use "hot keys" 
to activate SuperKey features. 

• Chapter 4 gives you some hints and techniques for using SuperKey with your 
favorite word processor or spreadsheet program. 

• Chapter 5 provides details about advanced macro use. It discusses the Super- 
Key macro editor, which you use both to design complicated macros and to 
change a macro you've defined earlier. It also covers display and auto-start 
macros. 

• Chapter 6 teaches you how to redefine your keyboard layout. 
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• Chapter 7 provides — in alphabetical order — detailed information about all 
SuperKey features. Examples are included. 

• Appendix A describes how to use SuperKey with other Borland products. 

• Appendix B explains how to automatically load SuperKey using batch (. BAT) 
files. 

• Appendix C tells you how to custom-install SuperKey — screen type, colors, 
and macro memory size. 

• Appendix D briefly describes each of the macro (.MAC) files supplied on your 
distribution disk. 

• Appendix E explains some basic DOS concepts, such as directories and the 
AUTOEXEC.BAT file. 

• Appendix F answers commonly asked questions about SuperKey. 

• Appendix G is a glossary of terms used in this manual. 



The Distribution Disks 



Your distribution disk contains the main SuperKey program and several other 
files. Information about each of these files can be found in Chapter 1, pages 
6 and 7. 

SuperKey is not copy-protected. Please note that Borland's no-nonsense 
license statement licenses you to use your copy of SuperKey as if it were a book. 
It is not licensed to a single person, nor is it tied to one particular computer. The 
only restriction on using SuperKey is that it must not he used by two different 
people at the same time, just as a book cannot be read by two people at the same 
time. And, of course, giving away copies of SuperKey to others would be a viola- 
tion of Borland's copyright. 

Please sign and return the license statement so you can be kept up to date 
about SuperKey and other Borland products. 



Minimum System Requirements 



To use SuperKey, you should have the following: 

• IBM PC or compatible 

• PC-DOS or MS-DOS operating system, version 2.0 or later 

• 128K RAM internal memory 

Introduction 



Acknowledgments 



In this book, references are made to a number of trademarks: 

• Turbo Lightning is a trademark and SideKick, Turbo Pascal and SuperKey are 
registered trademarks of Borland International, Inc. 

• IBM is a registered trademark of International Business Machines, Inc. 

• Volkswriter is a registered trademark of Lifetree Software, Inc. 

• Lotus 1-2-3 is a registered trademark of Lotus Development Corp. 

• WordStar is a registered trademark of MicroPro Corp. 

• Ready! is a trademark of Living Video Text, Inc. 



SuperKey Owner's Manual 



H A P T E R 



J 



Getting Started 



This chapter contains the information you need to make work disks and load 
SuperKey. 



Getting SuperKey Into Your System 



The first thing you should do with SuperKey is make a copy of the distribution 
disk. Always use this copy for any work you do with SuperKey. This way, if the 
work disk is damaged or erased, you can easily rebuild it from your original. 

Use the DOS (operating system) COPY program to copy all the files on your 
SuperKey distribution disk onto your work disk. Assuming your work disk is in 
drive B: and the distribution disk is in drive A:, type 

COPYR:».»B:E} 

to transfer SuperKey to your work disk. 

You now have a working copy of SuperKey, ready to load and run when you 
need it. 

Before you do anything else, please type READ-ME on the DOS command 
line for important information. 



If you have a hard disk, you could set up a subdirectory for SuperKey, for 
example one called \KEY. To do this, log onto the hard disk (usually drive C:), 
then type 

MKDIR \KEY S) 

Now put the distribution disk in the floppy drive, change to the \KEY direc- 
tory, and copy all SuperKey files to the hard disk. Type 

CHDIR \KEY 
COPY A:».« C 

For more information about directories and other DOS features, see 
Appendix E. 



Fiks on Your Diskette 



Following is a brief description of the files on the distribution disk. 

KEY.COM 

The SuperKey program. All SuperKey functions are collected in this one file, 
and it is the only file you 7nust have on your work disk when you start Super- 
Key. Once SuperKey is started, even this file is not absolutely necessary 
anymore. 

KEY.COM 

includes our highly efficient proprietary algorithm for file encryption. It pro- 
tects your files against all but the most sophisticated intruders. For maximum 
security, use the DES standard file encryption in KEYDES.COM. 

KEYDES.COM 

KEYDES.COM is the same as KEY.COM, except that it uses the DES stan- 
dard file encryption algorithm for maximum security. The cost of this higher 
security is that SuperKey won't perform quite as quickly. 

KEY.HLP 

Contains the SuperKey help information that appears when you press |F1 I . 
This file may be left oflpyour disk when running SuperKey if you don't want to 
use the built-in help system. If you want to use the help system, the file must 
be on the disk and directory from which you start SuperKey. 

LAYOUT.COM 

The keyboard layout editor. This is used to create new layout definition files or 
edit existing ones, and is only needed on your work disk if you want to edit 
your keyboard layout. 
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KEYINST.COM 

Installation program which lets you change the macro memory size and colors 
used by SuperKey. Installation is purely optional, and you can leave this file 
oflFyour work disk if you wish. 

PCJRINST.BAT 

This file contains the necessary commands to get SuperKey running properly 
on the PCjr. It needs to be run only the very first time you use SuperKey. 
Once you have installed SuperKey for the PCjr, you simply have to type KEY 
as you would with any other PC-compatible machine. 

.MAC 

Files with the last name MAC are SuperKey macro definitions. Their first 
names imply their use: WS.MAC, for instance, contains macros to be used 
with WordStar. See Appendix D for a list of . MAC files. 

.LAY 

Files with the last name LAY contain alternate keyboard layouts. Again, the 
first name indicates the type of layout. 

LETTER.TXT 

A sample text file that you can use to try out SuperKey's file encryption. 

READ-ME.COM 

This file contains the latest updates on SuperKey and any last-minute changes 
to this manual. Type READ-ME to see this information. 



Files NeededWhen Running SuperKey 



Once you have loaded SuperKey, the file KEY.COM (or KEYDES.COM) is only 
required on your disk when you want to save setups, options, and defaults. So if 
you are short on disk space, you can start SuperKey and then remove the disk 
with KEY.COM on it. Just remember to re-insert it in the same drive before 
attempting to save anything. 

But be careful! DOS sometimes loses track of what's on your disks when you 
"swap" disks, and that can result in partially destroyed files, or even an entirely 
scrambled disk. 

As a precaution, you should therefore press I ctn If cl after you re-insert a disk 
and before you save anything on it. This assumes that you are in DOS when you 
swap disks. You should never swap disks if you are running any program (unless 
that program tells you to do so, of course; then you are safe). 
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If you are using MS-DOS 2.11, you must install the ANSI. SYS driver into your 
CONFIG.SYS file. If you already have a CONFIG.SYS file on your root direc- 
tory, then edit it with your word processor or EDLIN and add the statement: 

DEVICE=fiNSI.SYS 

If you do not have a CONFIG.SYS file, you can create one by typing from the 
DOS prompt (on your boot disk): 

COPY CON CONFIG.SYS £] 
DEVICE=aNSI.SYSE] 

Be sure to put a copy of ANSI. SYS into your root directory. 



Installation 



SuperKey comes installed for an IBM PC or compatible computer. It is only 
necessary to go through the installation procedure if you are not satisfied with 
the pre-set values for color scheme, macro memory size, and screen type. 
Appendix C contains all the information you need to install SuperKey. 

Note: If you want to install SuperKey on a PCjr, type PCjr on the DOS com- 
mand line prior to using SuperKey the first time. 



Using SuperKey With Other Resident Programs 



SuperKey is a resident program, which means that once it is loaded into mem- 
ory, it stays there until you switch off the computer. SuperKey is therefore avail- 
able to you even while you run other programs, such as a word processor or a 
spreadsheet. 

You may be using other resident programs with your computer, such as Bor- 
land's Side Kick and Turbo Lightning, or a print spooler or RAM disk. If you are 
using other resident programs, it is essential that you load them in the following 
order: 

• Load any non-Borland resident programs first (print spoolers, RAM disks, 
etc.). 

• Load SuperKey next. 

• If you have it, load Borland's Turbo Lightning. 

• Finally, if you are a Side Kick user, load Side Kick last. 
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There is an exception to this rule: If you have another resident program that 
you want to use with SuperKey (and/or Turbo Lightning), load it after SuperKey 
(and Lightning). For instance, if you use Ready!, a resident outline processor, 
and want to write SuperKey macros and check spelling when you are within the 
Ready! program, you would load your programs in this order: 

• SuperKey 

• Turbo Lightning 

• Ready! 

• SideKick 



If You Use Tree-Structured Directories 



If you use a tree-structured directory, it is important that you change to the 
directory where you keep SuperKey 's .COM and .H LP files before you start 
SuperKey. 

This is because SuperKey must know where to find these files when you save a 
SuperKey setup or when you use the on-line help system. 

If you use an AUTOEXEC.BAT file to set up your computer automatically 
each time you turn it on, please see Appendix B for instructions. 



How to Start SuperKey 



Once you have SuperKey on your work disk, type 

(TJ(T|(Tj(3 

to start it. The only file required on your disk at this point is KEY.COM. Please 
be sure to follow the previous instructions about using SuperKey with other 
resident software. 

The message shown in Figure 1-1 will tell you that SuperKey is now loaded 
into memory and working. The memory information tells you how much RAM 
memory is left for running other programs. SuperKey's use of RAM is described 
in greater detail on page 145. 

Although SuperKey is now waiting in the wings, you can't see it. To get in 
touch with it, you must press special keys, as described in the next chapter. You 
can also pass commands directly to SuperKey on the DOS command line. See 
page 77 for details. 
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Figure 1-1 Log-On Message 



How To Kill SuperKey 



At some point you may need to "kill" SuperKey- — remove it from memory if you 
need to free up space for other programs. This may be desirable if you need to 
create more room for other programs without resetting the computer. 

But it should be done with caution, and only after observing the following 
rules: 

• It must only be done if there are no other programs in memory after Super- 
Key. This means that you must not kill SuperKey if you have an application 
program running. That is, be sure you are on the DOS command line before 
you kill SuperKey. But first, be certain there are no other resident programs 
loaded after SuperKey. This means that if you have Turbo Lightning and/or 
Side Kick in memory, you must kill them first. 

• Kill the programs in the reverse order they were loaded in — i.e., SideKick, 
Ready!, Turbo Lightning, then SuperKey. If you kill SuperKey while other 
programs occupy memory "above" it, you will create an unoccupied "hole" in 
memory — a situation that DOS cannot handle. You will have to reset the com- 
puter, and perhaps even turn it off and hack on again. 



To kill SuperKey, call the main menu to the screen by pressing (AJtjTj. Then, 
hold down the I Ctrl I key and press the I Home I and lEndj keys. 

You are now ready to use SuperKey. The following chapter takes you on a 
guided tour through the system. If you spend a little time with Chapter 2, you'll 
be sure to get the most out of your SuperKey. 
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Getting to Know SuperKey 



This chapter will get you oflPto a quick start with SuperKey. We'll explain how to 
use the menu system, how to create and use macros, how to encrypt and decrypt 
files, and more. This chapter introduces you to macros. For more detailed infor- 
mation, see Chapter 5. 



Putting SuperKey to Work 



To get in touch with SuperKey 's menu system, press 

rAitTT 



that is, hold down I Alt I and press Q. You can press these keys at any time while 
your computer is running to call SuperKey to attention. The window shown in 
Figure 2-1 will appear at the top of your screen. 




Figure 2-1 Main Menu 

This is SuperKey's main menu, which will allow you to access all its functions. 
There are two ways to select a menu item: 

• Move to the right or left with the Q and Q keys. When the item you're 
interested in is highlighted, press the 1-^1 key to open a pull-down menu 
containing details about that item. 

• Press the key corresponding to the letter that is capitalized in the item. For 
instance, to select Macros, simply press (^ (upper or lowercase), and a pull- 
down menu for Macros will appear. 

When SuperKey's menus are on the screen, you are, in eflPect, inside the 
SuperKey world; your application program is temporarily suspended until you 
have finished telling SuperKey what you want it to do. To make the main menu 
disappear and return to your application program, press I Esc I . 

SuperKey is still in your system, ready to appear again when you press 
l^'t f r\. Whenever any of SuperKey's menus or windows are on your screen, you 
can always make them disappear by pressing I Esc j . 

Instead of using menus, SuperKey also allows you to use special "hot keys" to 
get in touch with its functions. See Chapter 3 for details. 

Note that the Functions header is dim. This means that you cannot use Func- 
tions at this time; functions can only be called from within a macro (See page 12.) 



How To Get Help 



Chapter 7 contains detailed explanations about everything you need to know 
about SuperKey. Appendix F, Help!!! answers many of the most commonly 
asked questions about SuperKey. But there is an easier way that will answer 
many of your minor questions. 

That's the SuperKey help system. Whenever you would like a little assistance, 
just press 
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and you'll get a helpful explanation about whatever you are doing. The 
KEY.HLP file must be present in the same drive and directory as it was when 
Super Key was loaded. 



Record Your First Macro 



You are now ready to start recording a macro. A macro is simply one or more 
characters — text, numbers, or commands — ^which you record in SuperKey's 
memory and assign to a single key. Each time you press that key, all the recorded 
characters are played back, just as if you had entered them on the keyboard. 

You can imagine SuperKey as a kind of tape recorder that you can start and 
stop at any time. When started, it will record everything you do on the key- 
board; you can play back your recordings later just by pressing a key. 

Right now you want to record a macro, so move the highlighted bar to Macros 
and press l-^i or just press (^ to open the Macros pull-down menu. Figure 2-2 
shows what you'll see. As on the main menu, you can either move the high- 
lighted bar and press l-^l or you can press the key corresponding to the upper- 
case letter of the desired item to select a menu item. 
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Figure 2-2 Macro Menu 

Since you want to begin recording a macro, move the bar to Begin and press 
l-^-*! - or just press [^. 
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The menus disappear, and a small window now requests you to press the key 
you want to define (to hold the recording). For this example, press 

A line now appears at the top of the screen, informing you that you are in the 
process of recording a macro (unless you are currently using a graphics screen — 
e.g. Reflex; in that case, the status line does not appear). It shows you which key 
you are recording in, and tells you how to stop recording with the fAin Fl hot key. 

Anything you enter now will be recorded in SuperKey's macro memory, and 
assigned to the key IF4 j . Let's enter a command to the operating system (well 
just call it DOS from now on — it's short for Disk Operating System). For 
example: 

DIEEl 

Note that this command goes to the computer as usual, as well as to Super- 
Key's macro memory, so you will get a directory listing on your screen. Super- 
Key is completely transparent to DOS and other programs; that is, programs do 
not "know" that SuperKey is there in the background, recording everything you 
type. Now, to end the recording of this macro, press 

to get the Macros menu back, and 

to select End. The macro "tape recorder" stops, and the IF4 I key contains the 
keystrokes DIR l-»-'l . To play back the macro, just press IF4 I . Each time you press 
|F4 I . the command you recorded (DIR) is played back and gives you a directory 
listing, just as if you had typed it on the keyboard. 

As a matter of fact, the program (whether it is DOS, a word processor, or any 
other program) actually "thinks" it is still you typing away out there. From the 
program's point of view, there is no diflPerence between normal typing and macro 
"playback." 

This is the interactive way of recording a macro: you record the macro while 
doing your work as usual and you immediately see what the macro will do. There 
is another way to record macros or to make changes to the ones you record 
interactively. This involves the built-in macro editor which is described in 
Chapter 5. 
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Now, that was simple — and in principle that's all there is to it. Of course, 
macros can be more sophisticated or they wouldn't be of much use. But even 
with complicated macros, it all boils down to these simple steps: 

1. Turn on recording: fAitm {M} (TJ. 

2. Press the key to hold the recording. 

3. Enter the macro using the keyboard as usual. 

4. Turn oflP recording: (^OQ dJ CO- 

5. Press the key again and the recorded macro plays back. 

DOS Commands Made Easy 



when you are working with DOS or other programs, such as WordStar or Lotus 
1-2-3, there are a number of commands you will probably use repeatedly. Some 
examples: 

DIR to view the contents of your disk 

CHKDSK to check the disk status 

COPY to copy files 

MKDIR to make a new directory 

WS to start WordStar 

LOTUS to start Lotus 1-2-3 

It would be nice to avoid typing these commands over and over; pressing a 
single key would be much more convenient. Easy! You have already recorded the 
first command, DIE, in 1^4 I : let's record the other five. Press 

CHKDSKI 
COPY 

HSei 
LOTUS 
MKDIR 

Now, each time you press |F2 I . you will run the CHKDSK program, |F3 j will 
start copying, etc. If you get this message from DOS when you try these macros: 

Bad coniniand or file name/ 

it just means that DOS can't find the command (for example, if WordStar isn't on 
the current directory). All a macro does is record keystrokes — it can't actually 
execute commands. Some of these macros execute immediately when you press 
the function key because you entered a I'^l (RETURN) into them, while, for ex- 
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ample, |F3 I (COPY) waits and lets you enter a space, then the name and destina- 
tion of the file you want to copy, then expects you to press l-^i before executing. 
(This special kind of macro uses fields, which are described fully in Chapter 5.) 

These six macros, of course, are just small examples of what you can make 
macros do for you. Remember that a macro will do anything you can normally do 
on the keyboard. 



Which Keys Can You Use? 

Once you start using macros extensively, you will need more than the ten func- 
tion keys |F1 I through |F10| . SuperKey lets you use almost any key on the key- 
board for macros with the following shift-state keys: 

(ATj [cHJ (^ (either shift key) 

A key combination is achieved by holding down one of these three shift-state 
keys while pressing another key. You know this technique from a normal type- 
writer: to produce uppercase letters, you hold down the shift key, then you type 
the letter. Same thing with the I Ait j and I Ctrl | keys: to produce an I Alt |F6 | combina- 
tion, for example, you hold down the I Ait j key and then press IF6 I . 

In this handbook, key combinations are symbolized by two keys close 
together: 

rctrTYT 



This means: hold down the I ctn I key and press the (^ key. Sequences of separate 
characters are separated by white space, as shown here: 

COS 

This means: first press and release [T|, then press and release l-^l . 

Although you can use normal alphabetic or numeric keys such as (^ or {T} for 
macros if you wish, you will get a warning if you try it. This is to protect you from 
inadvertent use of these keys. We suggest that you primarily use: 

• the function keys fpn through fFiol . alone or with F^ - ("ctril . or fAin 

• the dedicated function keys I Home I . Hiidl . fPglJpl . I PgDn I . pns] . and ^, alone or with 

CctFlnrrAin 

• [a^ through (TJ and (Tj through (TJ in combination with fctril or fAin 

This gives you a total of 130 keys for macros, and that should be plenty. The 
reason we discourage the use of normal keys for macros is that it could easily 
cause confusion if, for example, your [£j key no longer produced a C, but started 
a COPY. Better use {^J^ or [ctrr|(T| for such a macro. 
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There are a few keys and key combinations that cannot be used for macros; 
please check page 143. 



Skip A Macro 

while we are on the subject, you might find yourself in a situation where you 
have recorded a macro in a certain key, but now you want to use the original 
meaning of that key. No problem — SuperKey has a command that lets you skip a 
macro and access the original key. 

If you have recorded the macros we have suggested, your IF3 j now contains a 
COPY command. If you want to use |P3 I as usual (to replay a command you give 
DOS), simply activate the skip command before you press |F3 | . as follows: 

This will skip the macro in |F3 | . and the key will have its usual effect. 



If You Dont Like Menus 



You might think it's a bit too much to have to press four keys just to skip one 
macro key. Well, there is an easier way to activate the skip command. The Q 
key (the "back quote" located just above the right-hand l-^l ) will do the same as 
the [AirXO CO CO sequence. 

In fact, each of the SuperKey commands you use often can be activated by a 
single keystroke. The drawback to single-keystroke commands is that they have 
to be learned and memorized — and they are not terribly obvious. So we'll stick 
to the menu system in this chapter. We describe how to use SuperKey without 
menus in Chapter 3 and throughout the alphabetical lookup in Chapter 7. 



How to Stop a Macro 



Suppose you want to stop and get out of a macro recording — maybe because you 
started it by mistake, you lost your way, or you made some errors and want to 
start over. 

Or suppose you want to stop macro playback. Say, for example, you made a 
macro "call itself Now it runs in an infinite loop, like a dog chasing its own tail. 
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The stoP command will stop a macro in its tracks. Just press 
fctFTTEin or (aTIQ (TJ (T| 

and playback, as well as recording, stops immediately. Anything you have 
recorded is discarded — it's as if it never happened. 

Save Macros On Disk 



The macros you have made are all stored in SuperKey's macro memory. The 
macro memory is a part of your computer's main memory that SuperKey has 
reserved for macros. However, if you don't save your macros on disk, they will be 
lost when you reboot the computer (by pressing ictrilAit i PeTI) or when you turn 
it off 

If you want to use the macros later, they must be stored in a file on disk. To do 
that, press I Ait f Tj to see SuperKey's main menu. Move the cursor to Macros and 
press (^) or just press Fm) . 

Now select Save. Move the cursor to Save and press l-^l or just press {^. The 
window shown in Figure 2-3 appears, requesting a name for the file in which to 
save the macros. Enter a file name, followed by l-»-'i . This name can be up to 
eight letters long. It's a good idea to let the name indicate the purpose of the 
macros in it. The macros we created for DOS could be called COMMANDS, 
since they contain DOS-command macros. 
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Figure 2-3 Save Macro 

All the macros currently in macro memory are saved under the same file name 
when you select Save. If you want to save macros in separate files, you have to 
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reset the computer for each file, enter macros individually, then save them 
under diflPerent file names. File names are discussed in detail on page 123. Right 
now you just need to know that a file name consists of a first name, which is the 
one you enter, and a last name of up to three letters, separated from the first 
name by a period. The last name of a macro definition file is automatically MAC, 
so if you enter the name COMMANDS, the file will be called COMMANDS. 
MAC on disk. If you don't like . MAC you can enter a full name, complete with 
last name, for example COMMANDS. DEF (remember the separating period). 

The macros in SuperKey's macro memory have now been written to disk, and 
you can reset or turn ofi"the computer without losing them. By default, all .MAC 
files are written to the same disk and/or directory where the SuperKey program 
is stored. If you want to change this, use the Setup menu. See page 27. 



Clear Macro Memory 

Suppose you want to use your keyboard as usual, without any macros. The sim- 
plest way to do this is to clear all macros from memory. Now that you have saved 
your macro definitions in a disk file, you can safely clear them, since you can 
always reload them later (see the next section). Press 

to select Macros Clear from the menu. All macros in memory are now erased. . 



Load Macros From Disk 



Now let's read back the macros you just saved on disk. Press 

(AirjTjdlCD 

to select Macros and Load. Enter the file name you used when you saved your 
macros. The macros in the file will be loaded into memory and become active 
again. 

If there are any macros in memory, they are replaced by the macros you load. 
There is a way to merge two or more macro files together in memory; see 
page 148. 
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Delete A Single Macro 



What if you want to delete just one macro and leave the rest intact? You simply 
record an "empty" macro in that key, by pressing the key itself when recording. 
Let's delete the macro in IF^ I . Press 

The macro in IF4 I is deleted, and the normal use of the key is restored. 



Macro Titles 



Giving your macros titles (a longer description than the file name) helps you 
remember what each macro is used for and also makes it easier for others to use 
macros that you design. Once you have given a macro a title, it will be displayed 
along with the name of the key in the shoW titles window (see the next section). 

Let's redefine IF4 I (the DIR macro) and give it a title. Press 

fAinrn nvTi iTj [FTj niR 

to define the macro as the DOS DIR command. SuperKey will ask you if you 
want to redefine the |F4 I key. Answer "Y". Then press 



to make the title. A window appears, where you enter the title you want to give 
the IF4 I key. A good title might be the following: 

List of files on this disk 

You can enter up to 30 characters. When you press l-^-^l . the window closes, 
and the title is recorded in the macro. Finally, press 

as usual to end the macro. 



Show Us Your Macros 



Although macros are indeed very useful, this is true only as long as you know 
they are there — and even more important, what each of them does. SuperKey 
therefore provides a window that gives you this information. Select shoW titles 
from the Commands menu: 
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A window now appears, listing the keys currently defined as macros and their 



titles. If there is more than a page full, you can page through them with the I PgO" I 
and IPgUPJ keys. You must press I Esc I to close the window before you continue 
working. As long as the shoW titles window is on the screen, you are not in touch 
with the program underneath, and you cannot play back macros. 



Ready-Made Macros 



One of SuperKey's strong points is its ability to create customized macros for 
each application program you use. Some samples of ready-made macros for var- 
ious uses are provided on the distribution disk in the files with the last name 
MAC (for MACro file). To find out about the macro, load the file into SuperKey's 
macro memory. Information about each of these files can be found in Appendix 
D. Help information will appear in a window. 

If you followed our example earlier, you have already created your own set of 
macros for use with DOS and saved it in the file COMMANDS. MAC, but the 
file DOS. MAC on the distribution disk contains a more sophisticated set of 
macros for use with DOS. 

To load the DOS macros, press I Alt f Tj to access the main menu, then select 
first Macros, then Load. When asked for the name of the file to load, enter: 

DOSej 

SuperKey supplies the last name MAC automatically. The DOS macros are 
now read into memory, ready to use. But something unexpected happens when 
you load this macro: a window with a helpful description of the macro pops up in 
the middle of the screen. This is a display macro, a macro that is not sent to the 
computer via the keyboard as usual, but instead displayed on the screen. But 
how did it get there? You didn't press anything. Well, it is also an autO-start 
macro; one that always starts automatically when the macro file is loaded. In 
Chapter 5 you will learn how to make your own display and autO-start macros, 
but let's play with this one for a minute. 

What you see is only the first page of help on your DOS macros. You can press 
I PgDn I to see more, and |Pg"Pi to page back again. Once you have read the text, 
press I Esc I to close the window. You must close it before you can do anything else. 
As long as the display macro is on the screen, you are not in touch with the 
program underneath. Like the shoW titles window, display macros are not trans- 
parent. 
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Before you go on, maybe you should try some of these DOS macros to get 
really familiar with using SuperKey macros. Remember that I Alt j Tl fc^ [W\ will 
display a list of currently loaded macros and their titles. You can press IF1 I to 
get help. 

By now, you should have a basic idea about macros and how to use them. More 
advanced information can be found in Chapter 5. 



The Functions Menu 



Functions make a macro perform various tasks when it is played back, such as 
displaying the time or date, or switching the screen off and on. You record a 
function in a macro by selecting it on the Functions menu while you record the 
macro. This is the only way you can get to the Functions menu — ^while you are 
recording a macro. Otherwise, the menu will appear to be dimmer than the 
other menus and won't be accessible. 

Let's take a look at some functions you'll probably use often. Detailed informa- 
tion about all SuperKey functions can be found in the alphabetical lookup in 
Chapter 7. 



Time Stamping Your Data: Time Function 



Suppose you keep notes on your telephone conversations. If you have a real time 
clock installed in your computer, it would be useful to have a macro that prints 
the time, followed by a I-*-*! to let you start writing the note on the next line. 
Let's record such a macro in I Alt K Tl (for time). Press 



This starts recording the macro, brings up SuperKey's main menu, and opens 
the Functions pull-down menu, which is shown in Figure 2-4. Now press [2 to 
select the Time function (or press Q to move the bar down to Time, then press 
[•♦"'I - if you prefer). You have now recorded the time function in the macro. 
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Figure 2-4 Functions Menu 
Finally, press 

to stop recording. 

Each time you now press [Alt I fTi. the time will be read from DOS and printed 
out, followed by a return. 

May We Have Some Privacy, Please: The Screen Ojf Function 



Have you ever been in the middle of a confidential document when someone 
walked in and looked over your shoulder? Embarrassing, right? What does one 
do? Ask the person to leave, hurry to save the work, or what? 

No problem. Just make yourself a couple of macros that turn the screen off at 
the click of a button, then back on again, without disrupting your work. For 
example: 



Now all you need to do to hide your work from prying eyes is to press I Ctrl f o 
Press I Ctrl I T), and your screen display is back. 



Getting to Know SuperKey 



23 



Freeze Those Keys: The Keyboard Lock Function 



For even more security, you could add a keyboard lock function to the screen oflp 
macro. Then you could safely leave your computer, and no one can gain access to 
it. Press 



When you play back this macro (by pressing IctnjfT) ). you are prompted for the 
keyword that will unlock the keyboard again. Enter it once, then re-enter it for 
verification. Press l-^i each time. 

Your keyboard is now locked. The next thing you recorded in the macro was 
the Screen off function, so the screen is turned off. 

The only way to gain access to the computer now is to enter your secret key- 
word again. This time, you need not press !'♦•-' I . As soon as the keyword is recog- 
nized, the keyboard is unlocked. You can then press I Ctrl ifTl to turn the screen 
back on. 

For even greater security, you can activate the keyboard lock function on the 
DOS command line. This means you can load SuperKey from a batch file (such 
as AUTOEXEC.BAT) and lock the keyboard at the same time. Even if someone 
comes along and turns off your computer, the keyboard will lock again when the 
computer is turned back on. 

Here's what to do: Insert the following line in your AUTOEXEC.BAT file: 

KEY/FKnnnnnnnn 

where nnnnnnnn is your password. 

Now, when you reboot your computer, your keyboard will lock automatically. 
All you have to do is type your password to gain access. 

Another alternative would be to include the keyboard lock function and your 
password in a macro file. That way, you don't have to enter your password each 
time you want to lock your keyboard. 

For example, you could program the I Ait jT) key sequence to lock your key- 
board with the password /reeze as follows: 

Using a text editor (or the Side Kick Notepad) create the following file: 

<BEGDEF><AltL><CMD> FKfreeze <CMD><ENDDEF> 

Load this file into SuperKey, then press I Alt KTl . Try your keyboard — it should 
be locked. Now type freeze to unlock it again. 
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Encryption 



Now let's look at some other SuperKey features you are likely to use a lot. The 
first one is file encryption. Encrypting a file means scrambling it so no one can 
make use of it — that is, unless they have the keyword that will decrypt (or 
unscramble) it again. 

SuperKey offers two distinct file encryption schemes: 

• A fast method which should cover the need of most users. Unless you are 
dealing with government secrets or other high-security data, you'll be safe 
with this. If you want to use this type of encryption, you should start Super- 
Key with the command 

KEY ei 

because this algorithm is in the file KEY.COM. 

• The DES file encryption scheme. This encryption complies with the Data 
Encryption Standard issued by the National Bureau of Standards. It provides 
the maximum security needed for highly sensitive data, prone to threat by 
intruders with access to sophisticated code-breaking facilities. The security is 
not without cost, however — this encryption is significantly slower than the 
other. 

If you want to use DES encryption, you should start SuperKey with the 
command 

KEYDES ej 

because this algorithm is in the file KEYDES.COM. Now, let's try it. If you 
haven't yet done so, you should copy the file LETTER.TXT from the distribution 
disk onto your work disk. Then enter this command to display the letter on the 
screen: 

TYPE LETTER.TXT £] 

You will see that the letter is perfectly readable. Now invoke SuperKey's 
encryption by pressing 



The Encryption menu first lets you choose between Encrypt file and Decrypt 
file. Encryption takes a normal file and turns it into unreadable ciphertext. 
Decryption reverses the process — takes the ciphertext and turns it back to 
normal. 

Select Encrypt file. Enter the name of the file you want to encrypt: 

LETTER.TXT EJ 
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Now enter your keyword. It can be anything you like (up to 30 characters 
long), but be sure to choose something you have a good chance of remembering, 
because you can only decrypt the file with the keyword you used for encryption. 
After you've entered the keyword, you are asked to retype it to make sure you 
made no mistakes. If your second entry does not match the first, you must enter 
the keyword again. Finally, you are asked whether you want Text mode encryp- 
tion. Don't worry about that now; just press I'^l for No. 

SuperKey now encrypts the file LETTER.TXT. It physically writes the 
encrypted file on top of the original one, so no trace of the original file is left on 
disk. The file is completely safe from prying eyes. 

After you have encrypted a file, it's a good idea to make a backup copy of the 
encrypted file in case the original encrypted file is corrupted by tampering or by 
decryption with the wrong password. 

Now tell DOS to TYPE the file again. All you get on the screen is garbage, 
because that's all the file contains, at least to people without the keyword. 

To retrieve the original file, choose Decrypt file from the Encryption menu. 
Be sure to use the same keyword you used for encryption. The encryption pro- 
cess is reversed, and you can again TYPE the original file on the screen. 

Encryption works with any file or program. It even provides a way to turn a 
binary file (a program, for instance) into an encrypted text file. This text file can 
then be transmitted over the telephone line with any communications package. 
You can even use the bulletin boards on the public networks — only the author- 
ized recipient with the right keyword can turn it back into a program. 

Please read more about encryption on page 103 before you start using this fea- 
ture extensively. There are a few things you should be careful with. In particular, 
never try to decrypt a file that has not been encrypted. 



DOS Command Stack 



Another useful SuperKey feature is the DOS command stack. This little "tape 
recorder " runs all the time, continually recording all the commands you give to 
DOS. You can see these commands by selecting Command stack from the Com- 
mands menu. Press 



to open the command stack window. You will see the commands you have given 
DOS since you loaded SuperKey. Instead of having to retype DOS commands 
you use often, you can use the Q and Q keys to move the bar to the command 
you want to repeat. Then press l-^l to send that command to DOS again, or edit 
the command using the Q, Q, l-^^i . and {^H keys before you press l-^i . 
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Commands appear in reverse order from how you entered them, with the 
most recent command at the top of the stack. You can page through the stack 
with I PgDn I and (Wj. The stack contains the last 255 characters you entered on the 
DOS command hne. Excess commands are deleted from the bottom of the stack 
as it fills up. 

Press I Esc I to close the window without executing any commands. 



Type-ahead Buffer 



This is one SuperKey feature that you never actually see, although you use it all 
the time. Whenever SuperKey is loaded, the keyboard's buflFer is expanded from 
the normal 16 characters to 128 characters. This means you can go on typing 
even while the computer is busy doing something else, like reading or writing on 
the disk. You should never hear the "keyboard bufier full" beep again! 



Setup Menu 



The Setup menu lets you specify where SuperKey looks for its macro and layout 
files and where it looks for files to be encrypted. 

The standard (default) setup does not specify any disks or directories, so 
SuperKey will look for its files on the disk and/or directory where the SuperKey 
program is located. 

If this is OK with you, you need not bother with Setup. But if you are using a 
hard disk and want your macros placed in a separate directory, or if you are using 
floppy disks and you can't fit the macro and layout files on your work disk, you 
can use Setup to tell SuperKey to look for its files elsewhere. 

To open the Setup menu, press 

As with all SuperKey menus, you select an entry on this menu by moving the 
bar up and down, and pressing l-^-^l to select the desired entry, or you can just 
press the key for the uppercase letter in the entry you want. 
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Encryption Directory 



When you select this entry, a window opens, asking for the name of the directory 
where SuperKey will look for files to be encrypted. The directory name you 
enter can be a full DOS path name (see Appendix E for an explanation of direc- 
tories and paths), or it can just be a drive name, for instance A: or B:. If you just 
enter a drive name, the currently active directory on that drive will be used 
(DOS has an active directory for each individual drive). 

When you press l-^i . the window closes and the directory or drive you enter 
becomes active. If you want SuperKey to find its files on the drive/directory 
where the SuperKey program is located, don't enter anything, just press R-^ . 

If you want SuperKey to use the new setup next time you load it, you must 
record it permanently by selecting Save setup. 

Suppose you only want to encrypt files on the root directory of the A: drive. 
You would then enter 

(AjrjQ CO CO A:\ ej 

If you have a hard disk and want to encrypt files on a specific directory, say, 
\TEXT\LETTERS\PRIVRTE , you would enter 

(SQ [0 CO \TEXT\LETTERS\PRIVfiTE £] 

Or, to be more specific, you could include the drive name: 

SDQ CO CO C:\TEXT\LETTERS\PRIVflTE EJ 

If the window is not wide enough for the path name, it will scroll horizontally 
when you reach the right edge of the window. (This horizontal scrolling automat- 
ically takes place in all SuperKey windows.) 



Macro Directory 



This entry lets you specify the directory where your macro (.MAC) and layout 
(.LAY) files are stored. As with Encryption directory, the directory name can be 
a full DOS path name or it can just be a drive name. 

If you are using a floppy disk computer and cannot fit your macro files onto 
your work disk, you can put them on the other disk and specify that drive name 
as the Macro directory. For example, if you want to place your macro and layout 
files on the B: drive, you would enter 

fAitim CO CEi B: e) 
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or, you could place them in a separate subdirectory on the B: drive, for example 

B:\MAC 

fAinm (T| (¥] B:\HRC E) 

If you are a hard disk user, you might want to collect all macro and layout files 
in a separate directory, for example \MfiC. You would specify your Macro direc- 
tory as 

fAinrn (tj {W} c:\Mac ej 



Save Setup 



Any changes you make to the setup become active immediately, but they are not 
permanently recorded in SuperKey. So if you want your new setup to take effect 
the next time you load SuperKey, you must press (^ to save it. 

When you save a setup, the KEY.COM file must be on the disk and directory 
that was active when you first started SuperKey, because the new values are 
saved directly in this file. Please see page 9 for details. 



The Options Menu 



The main menu has an entry called Options, which is used to control several 
SuperKey features. A few of these features are described in detail here; see the 
alphabetical lookup in Chapter 7 for complete information about all the items on 
the Options menu. Press 



to open the Options pull-down menu, which is shown in Figure 2-5. Most 
options are toggles: if you select an option that is currently ON, it will turn OFF, 
and vice-versa. You can also press Q or Q to turn an option ON or OFF, 
regardless of its current state. As usual, you select an item on the Options menu 
either by moving to it with Q or Q, then pressing \-^\ . or by pressing the key 
corresponding to the capital letter in the item. 
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Figure 2-5 Options Menu 

The two delay options need a little more input. When you turn them ON, you 
are required to enter the length of the delay. 



One Finger Mode 



The one finger option lets you enter commands which normally require you to 
press two or more keys at the same time as a sequence of keystrokes. This will 
come in handy if you only have the use of one hand or must use a mouth stick. 

To reboot your computer, for example, you normally press 

rctrnfAinfDei 



all at the same time. That not only requires three fingers, but also two hands. If 
for some reason, you can't do that, switch on One finger mode. Then you can 
press the three keys individually, and the eflPect will be as if you had pressed 
them at the same time. 

The normal way to turn on One finger mode is: 

(AirxrjdJdj 

There is another way to do it without pressing I Alt ir7~| : You can pass the com- 
mand on the DOS command line. Instead of starting SuperKey with the DOS 
command 

KEY ei 

you would use the command 

KEY /DO ej 
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/DD is a command line parameter that is passed on to SuperKey. You can pass any 
command to SuperKey in this way at any time. Command hne parameters are 
described in detail on page 77. 

One last thing. If you would like SuperKey's commands to be single key- 
strokes instead of I Ait | and I Ctrl | key combinations, you can redefine all com- 
mands. See how on page 90. 



Suspend 

This is a way to temporarily deactivate SuperKey without removing it from 
memory, and without destroying macros or any of SuperKey's setup. 

You simply press 

(AjTiaiucE) 

to sUspend SuperKey. It is still there, but it no longer monitors your key- 
board. Therefore (since SuperKey is no longer able to receive its usual com- 
mands from you), the only way to turn OFF suspension and get SuperKey back 
in action is to enter the [£j (^ command on the DOS command line: 

KEY /OU eJ 

Disk Wait 



When programs read or write on a disk, they cannot also receive input from the 
keyboard, or from a macro. This usually doesn't cause any problems, because 
input is stored in a keyboard bujfer until the program is ready to receive it. 

Some programs, however, have a bad habit of throwing away characters sent 
to them while the disk is spinning (being read or written to). When you use such 
programs, you must stop and wait for the disk to stop spinning before you can 
type anything. You can tell SuperKey to do the same by switching on disk Wait. 
Press 



(AJOQiTldJ 

This only works on floppy disks. A hard disk spins all the time, so it makes no 
sense to wait for it to stop. 
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Bottom Line 



When you record macros, SuperKey displays a line at the top of the screen so 
you can see what you're doing, and what you can do next. If your program also 
uses the top line of the screen for its status or entry line, you can move Super- 
Key's interactive recording message to the bottom line of the screen by switching 
Bottom line ON. 

To do that, press 

(AJTiQ CD CO 

The next time you record a macro, the interactive recording message will 
appear at the bottom of the screen. To make the change permanent, you must 
save your options by pressing 



Playback Delay 



Macros are normally played back at full speed, which is close to 1000 characters 
per second. Some programs have problems receiving input at that speed. They 
may lose characters or start beeping furiously at you. If that happens, you can 
slow down playback speed by setting a Playback delay. 

The Plavback delay is by default, which means no delay. Values from 1 to 999 
introduce a delay between each character, thereby slowing down playback. The 
effect of a particular delay depends on the program that receives the macro, so 
you may have to do some experimenting to find the right values. 

To set the Playback delay to 5, for instance, press 

(aOLI d] CO CO ej 

If you want to make this delay permanent, you must save your options by 
pressing 

ocococo 

To a degree, the Playback delay is a matter of taste. Take WordStar, for 
instance. If you play back a macro with a lot of text at full speed, WordStar will 
start displaying exclamation marks on the screen. Everything is really OK; it's 
just that WordStar has trouble updating the screen while receiving input at full 
speed. As soon as the macro finishes, the screen will be corrected, and you'll see 
that everything went well. If you don't want WordStar to do that, however, you 
could set the Playback delay to 2. 
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Protect Delay 

This option lets you protect your valuable screen from "burn in." That's what 
happens when the same image is displayed on the screen for an extended period 
of time. The screen's phosphor becomes "worn" in places where characters are 
displayed, so after some time you'll see faint after-images on the screen, even 
when it is turned oflp. 

The way many of us use computers, they just sit there for long periods, waiting 
for us to enter something on the keyboard. During that time, there's really no 
reason to have anything on the screen. 

SuperKey will protect your screen by turning it off if there has been no activ- 
ity on the keyboard or the screen for a certain time. Whenever you touch a key, 
or your program writes on the screen, the screen display comes back. 

To activate the screen proTect option, press 

then enter the number of minutes you want the computer to wait before it turns 
oflFthe screen. The default time is five minutes, and you can press 

to accept that value. 

As with the other options, you can make the screen proTect time interval you 
just defined permanent if you save your options by pressing 



Save Options 



When you set your options as described above, they only stay in effect as long as 
SuperKey remains in memory. The next time you start SuperKey, the options 
are back to their defaults. 

If you want your new Options setup to be permanent, you must deliberately 
save it with the command 



Remember: Whenever you save anything in SuperKey, the KEY.COM file 
must be present on the disk and in the directory from where you started 
SuperKey. 
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How To Use SuperKey Without Menus 



Once you become familiar with SuperKey, you may want to take a few shortcuts 
and circumvent the menu system. 

All the frequently used SuperKey commands, such as Begin macro. End 
macro, shoW titles, Command stack, etc., can be activated with I Ait I or I Ctrl I and 
one other key. The drawback of these one-key commands is that they are not 
very obvious; they have to be learned. But once learned, they are faster to use 
than the menus. 

There is a good reason why these one-key commands are so cryptic. We could 
have chosen mnemonic commands like I Ait j TbI for Begin macro, I Ait 1 for End 
macro, etc., but that would render a lot of good key combinations unusable for 
the macros you create. So we let SuperKey use commands like I Alt ir =l. I Alt IP I. 
etc. , and leave the alphabetic keys free for you to use. If you still prefer to use 
mnemonic commands, you can change them as described on page 90. 

Table 3-1 lists the commands as we have installed them, along with the com- 
mands you would use in the menu system. Note that I Ait | F1 uses the Q key on 
the upper row of keys, next to the Q key — not the Q key on the numeric 
keypad. 
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Table 3-1 One-key SuperKey Commands 



Command 


One-key Command 


Menu System Keystrokes 


Menu 


(aoLI 




Begin macro 


lAiLxa 


lAitJQd]!!] 


Title 


^ilQ 


iAiijfr|f¥|fT] 


Fixed field 


lCtrl|T| 


[Air|rr|(¥j(T| 


Var field 


(arjQ 


|AltJ/J[M][Y) 


autO-start 


tAltJQ 


lAitj[r|[M|(T| 


End macro 


lA^ra 


tAitJQiMjITI 


cUt and paste 


(AltJUJ 


lAitjTjrMjruj 


Command stack 


lAlJT] 


iAitjfr|fT)fT] 


sKip macro 


□ 


(Air[Q(T|(T| 


stoP 


1 Ctrl! Esc 1 


(AitJQ (TJ (T| 


shoW titles 


lAlt iPrtScI 


lAitJTJ(T](WJ 
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Using SuperKey With Your 
Favorite Program 



This chapter provides information about using SuperKey with your text editor or 
spreadsheet. For information about using SuperKey with other Borland prod- 
ucts, see Appendix A. 

The distribution disk contains a number of ready-made macro files for use with 
various popular word processors and spreadsheets (see Appendix D for more 
information). Don't be upset if yours is not among them — you'll not miss much. 
They are merely meant as an inspiration for your own personal macros, not as 
something we think you will actually use (not for long, anyway). 

After all, the whole idea with macros is to let you create your own personal set 
of commands for your programs. It would be ridiculous if we tried to do that for 
you; SuperKey lets you decide for yourself Any time you find yourself repeat- 
edly typing the same words, commands, or numbers, create a macro to make 
things easier. 

One idea is to create and use the same macros to do similar things in different 
programs. For example, if you have different text editors, they are sure to use 
different commands for things like search-and-replace, save-and-resume, etc. 
With SuperKey macros, you can use the same command no matter which editor 
you use. 
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Take WordStar, for instance. It uses the command sequence I Ctrl f W\ I Ctrl IT rI to 
read a file into your document. If you want to do the same in Volkswriter, you 
must press I Alt |F2 | . If you use both these word processors, wouldn't it make life 
easier to have a read file macro like this for WordStar? 

(AiTxoCEIlIJSLOi 
fCtrTin rctriyR") 

(aoqEICO 

And, in another macro file, this one for Volkswriter; 

(Ayr^ (¥] (T| (Air|(T| 
rAinfF2~i 

when you run WordStar, load the file with the WordStar macros, and when 
you run Volkswriter, load the VW macro file. Then you can use the same com- 
mand I Alt f R\ to do a read file in either word processor! 

To make things even easier, you could make a . BAT file load the macro files for 
you automatically. Here's a file called WS.BAT: 

KEY WS /ML 

WS 

KEY /MC 

This .BAT file will first load the macro file WS. MAC, and then start WordStar. 
When you exit WordStar, the .BAT file will clear the macros from memory and 
return your keyboard to normal. A similar VW.BAT file will do the same for 
Volkswriter: 

KEY Vff /ML 

VW 

KEY /MC 

Note that we are using SuperKey command line parameters here — passing 
commands directly to SuperKey on the DOS command line. See page 77 for 
more information about command line parameters. 



Cut and Paste 



Have you ever wanted to grab text from somewhere else and move it into your 
word processor? SuperKey's cut-and-paste feature is easy to use and lets you cut 
text from your screen and paste it where you want it. Let's take a simple exam- 
ple. Exit to the DOS prompt ( A> or similar) and type 

DIR ej 
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This displays a list of all your files on the screen. Now let's move this list into 
your word processor. But first, press 

to activate SuperKey's cut and paste feature. 
Then press the key to hold your "cutting." For example: 

Now use the arrow keys Q, Q, Q, and (^ to move the cursor to where you 
want to start cutting. Then press 

Hi 

to begin cutting. Use the arrow keys again to move to the end of the cutting. 
You'll see it being marked on the screen as you move along. 

When the cursor is at the end of the block of text you want to cut, simply press 

to end cutting. Your cutting is now in the I Alt Ifc) key. 

Get into a file with your word processor, move to where you want the text 
pasted, and press 

{WJT\ 

Voila! The cutting is neatly pasted into your document. 

Some word processors might wince a little when you paste, especially if it's a 
large block of text. This is because they don't like to receive characters at the 
high speed SuperKey uses (nearly 1000 characters per second). If that happens, 
you can slow down SuperKey as described on page 155. 

Using SuperKey with a Spreadsheet 

when working with a spreadsheet, most people use the same commands over 
and over again. That amounts to a lot of keys pressed during the day. SuperKey 
macros can reduce these keystrokes to a minimum. 

The complexity of a spreadsheet program often baffles the casual user. Even 
though you really only need a handful of commands to do a few simple things, 
these commands must be found in different places in an often deeply nested 
hierarchy of commands. 

SuperKey lets you design personalized macros for everyone who uses the 
spreadsheet program, turning complex commands into single, easy-to-remem- 
ber keystrokes. 
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You can even use display-only macros to write personal help screens to help 
each user carry out specific jobs; display macros can provide help screens tai- 
lored for each job, or even for each person using the spreadsheet. If one person 
does data entry, and another person produces graphs, they need different help. 
See page 98 for more information. 

Take the 1-2-3 macros on the distribution disk, for example. 

Press 

fAinrri (¥] (tj 153 ei 

to load this macro file. A display macro with information about these macros is 
shown automatically when you load the file. Press [Escj to close the display macro. 
Then start 1-2-3. You can press I Ctrl I Fi | whenever you want to see the help 
screen again. These macros are not sophisticated, but they do show you how to 
turn some of the commands you use all the time into single mnemonic key- 
strokes. 

So, for example, whenever you want to switch between automatic and manual 
recalculation, you don't have to go through four levels of 1-2-3 menus; simply 
press 

(AinrMi 



for manual recalculation, and 

when you want to switch back to automatic. 

Same thing with global worksheet protection, for instance. If you normally 
have this feature on, but occasionally need to access one of the protected cells, 
you have to go to the main menu, then select Worksheet, then Global, then 
Protection, and finally Enable or Disable. It's only five keystrokes, but anyone 
who is not really familiar with 1-2-3 has to laboriously dig those keystrokes out of 
the menus. That's confusing and takes time. 

With SuperKey, you could just press 

fAitTol 



to disable protection, and 
to enable it again. 



40 SuperKey Owner's Manual 



Make a 1-2-3 Macro 



The sample 1-2-3 macros we provide, although useful, are only meant as exam- 
ples, and deal with some general commands. Once you get inside a worksheet, 
what you want to do is highly individual. It depends on how your worksheet 
looks. 

It's easy to make your own macros. All you do is press 

to turn on SuperKey's macro recording. Then press the key you want to hold the 
recording, and go to work. Anything you do now is recorded in a macro. 

When you finish whatever you are doing, press 

I Alt IF^ to stop recording. 

You can now repeat everything you did by pressing the one key in which you 
recorded the macro. 

If you don't want SuperKey to print its message at the top of the screen while 
you record a macro, you can move it to the bottom of the screen. Press 

to turn on SuperKey's bottom line option. In 1-2-3 you will definitely want to do 
that, because 1-2-3 also uses the top line for its messages. 



Playback Delay 



Most spreadsheets can't handle the speed at which SuperKey sends characters, 
so you'll want to use a playback delay in your spreadsheet macros. Try a delay of 
5; if that doesn't work, increase the number gradually. See page 155 for more 
information. 



Graphics 



Whenever SuperKey displays anything on the screen, it changes the display to 
text mode. So if you have a graph on the screen, it will turn into gibberish. Also, 
when SuperKey is used over a program that is in graphics mode, the command 
line is not displayed while you define a macro. 
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But don't worry. When SuperKey closes its window, it will turn the screen 
back to graphics. In any case, there isn't much for SuperKey to do while graphics 
are displayed. If you don't want this to happen, use the KEYINST installation 
program to blank the screen in graphics mode. See Appendix C. 
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Advanced Macro Use 



This chapter takes a more detailed look at macros. We'll cover auto-start and 
display macros, and discuss how to use variable and fixed fields in macros. We'll 
also show you how to use the macro editor to create more complicated macros 
and edit ones you already have. 



Auto-Start Macros 



An autO-start macro is a macro like any other, except that it executes automati- 
cally each time the file containing it is loaded. 

Let's add a new macro to the DOS macros on your distribution disk (described 
on page 21). If you haven't already, load the DOS macros into your computer. 
You will see help text displayed automatically — an autostart macro, which in this 
case is also a display macro (described in the next section). The new macro will 
display the active directory and the system time at the DOS prompt. We'll put it 
in an out-of-the-way key like I Ctrl | fio j . because it is not a macro you are likely to 
use from the keyboard; it's just there to execute automatically when you load the 
macro file. Record the macro as usual: 

fAinrn [fj (tj (wjrio] prompt $p $t $g ei 
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%J^Iow, to make it autO-start, select autO-start on the Macros menu: 

(Air|r|(¥j(T| 

and finally end the macro as usual: 

CAir|7^ (¥J |TJ 

Now, save your DOS macros with this change in a file called NEWDOS.MfiC: 
(AiriQ (¥] (T| NEWDOS e) 

And finally load your new DOS macros: 

(AirjITJ {¥} (Tj NEWDOS £) 

The macro you just defined plays back automatically when you load the file. 
The DOS macros on your distribution disk include a macro that displays help 
text automatically (autO-start). But a set of macros can have only one autO-start 
macro, so whenever you define a new one, the old autO-start macro turns into a 
plain old macro. 

If you still want the help text displayed automatically whenever you load this 
file, you can let the new autO-start macro activate the help text in Ifi I . To make 
fctrillFioi activate Ifi i . just add Ifi I to the end of your macro: 

With the arrow keys, move to the end of the macro file and type 

(<] (T| (T) (>] {WJ^ {Y} 

Now you must save this file so the next time you load it, you will get the 
display macro 

{WJT} (¥] (T| NEWDOS (Tj ^ 



These are just a few simple uses of autO-start macros, but they can be used for 
much more. You could, for example, design large self-running demos or tutorials 
with SuperKey, having one set of macros chain another, which then autO-starts, 
chaining yet another, and so on as far as your imagination takes you. 



Display Macros 



Display macros are a SuperKey specialty which really add value to your com- 
puter. With them, you can design your own individual help system for any of 
your favorite programs. For instance, you might want to create a little menu that 
shows all your macros, their titles and what they do, so you can share them with 
your friends or co-workers. 
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Since display macros are not merely strings of text or commands being sent to 
the computer, but text that is displayed on the screen, you will want to format 
them nicely. You must therefore use a text editor to write your display macros. 
This can be any text editor producing standard ASCII text files, such as EDLIN, 
WordStar in non-document mode, SideKick's Notepad, or the Turbo Pascal edi- 
tor. 

Many other editors can produce standard text files. If you are not sure what 
your editor does, ask DOS to TYPE one of your text files on the screen. If the 
text is displayed legibly, it's a standard text file. Even if your editor does not 
produce standard text files, it may have a way of doing so, perhaps by printing 
the text to a disk file. 

Let's try an example. Enter your text editor and create a new document. You 
could call it DISP. MAC, since it's going to be a display macro. On the first line of 
this file, you enter the information SuperKey needs to identify the file as a 
display macro. Enter everything exactly as shown below, including angle 
brackets. Both upper and lowercase letters can be used for all material enclosed 
in angle brackets. The first thing you should enter is 

<BEGDISP> 

This is a symbol that tells SuperKey that a display macro starts here. Right 
after that symbol, enter the name of the key in which you want to record this 
macro. Enclose the key label in angle brackets, so it also becomes a symbol. For 
example: 

<aitFiD> 

This symbol identifies the key combination I Ait |fio| . The next information 
you'll enter is the position and size of the window that will display this macro: 

55, q, 3D, a. 

The first two figures specify the column and line of the upper left corner of the 
window, the third figure is the number of columns (the width), and the last figure 
is the number of lines (the height). So here we have specified a window with its 
upper left corner at column 25, line 9. It is 30 characters wide and 8 lines high. 
Put a period after the window size. The first line of your file should now look 
like this: 

<BEGDISP><AltFlD>E5,q,3D,fl. 

Beginning on line 2, you should now type the text you want the macro to 
display. Remember that you have specified a window width of 30 characters, so 
this should be the maximum length of your lines. Longer lines will be truncated 
when displayed. 
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\ Although you have specified the window height to be 8 hues, this does not 
mean that you are Hmited to writing 8 hnes of text. If you type more than that, 
SuperKey automatically divides the text into pages, and you can page through it 
with I PgDn I and (W. 



Now type 10 or 12 lines of text. For example: 

Welcome to MoneyManager 

With MoneyManager, you will 

never be short on cash, nor 

will you ever exceed your 
personal credit limit. 

The following pages will show 
you how to make MoneyManager 
perform this incredible feat, 
so please stay with us. . .<ENDDEF> 

The last thing you should type is <ENDDEF>. This symbol tells SuperKey the 
macro ends here. 

Now save this file on disk and load the file into macro memory: 

OQ El CD Disp.MRc ei 

Then press I Alt IfFiol . The text you just wrote will pop up in the middle of the 
screen, with its upper left corner in column 25, line 9. 

Note that the upper left corner you specified will be the upper left corner of 
the frame surrounding the text, and the number of lines and columns you speci- 
fied will be the number of frames within the window. So, counting the frame, 
the whole thing takes up two extra columns and two extra lines. (SuperKey gives 
you a frame to enhance the display of your text.) 



Pages 



If you copied the example faithfully, you will see that your 8-line window breaks 
the text in the middle of a paragraph. You can avoid that by forcing a page break 
where you want it. The way to do that is to enter a Control-L where you want the 
page break. Call up your editor again and place a symbol representing a Control- 
L between the two paragraphs: 
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<BEGDISP><AltFlD>S5,q,3D,fl. 
Welcome to MoneyHanager 

With MoneyManager, you will 
never be short on cash, nor 
will you ever exceed your 
personal credit limit. 
<CtrlL> 

The following pages will show 
you how to make MoneyHanager 
perform this incredible feat, 
so please stay with us. <ENDDEF> 

If you use SideKick, you could insert a Control-L character in the document 
with the Notepad by pressing 

(£rlJTJ (CtrFJTj 

Save the file and load it into SuperKey again. Press I Ait |fio| to see the result. 
Only the first page is displayed. Press I PgO" i to see page two, and l^gUPl to return to 
page one. 

A display macro can be as long as your macro memory allows (determined with 
the KEYINST program; see Appendix C), with approximately 65,000 characters 
as the limit. Each window can be as small as one character by one line, or as 
large as 78 characters by 23 lines (the entire screen, when you add the frame), 
macro memory permitting. 

If you are running out of macro memory space, SuperKey will shrink the 
display window to conserve memory and still allow the macro to be displayed. 



Freeze Your Keyboard with a Display Macro 



You could use a display macro to freeze your keyboard and cover the entire 
screen to show that the computer is in use. Use your text editor to write this 
display macro: 

<BEGDISP><Ctrll>l,l,7fl,E3 
I'M OUT TO LUNCH 



Don't bother to call me unless it's VERY important! 
<ENDDEF> 

Now save it in a file, then merge it into macro memory. Press 

and enter the name of the file containing the display macro. The file is now read 
into memory, but the macros already in memory are still there also. 
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Unlike loading a new macro, merging macros does not clear other macros from 
memory, but lets you combine many macro files into memory "in parallel." See 
page 148 for more information about merging macros. 

Now let's make the I Ctrl fo^ macro activate the display macro in I Ctrl ITl : 

(aOCO (1] CO (CtrlJIT] 

(ATIQIIICO 

When you press I ctn i Tol and enter your keyword, the display macro will cover 
the screen, which is just as good as turning it off When you return from lunch, 
you'll enter your keyword to unlock the keyboard, then press I Esc I to end the 
display macro and get your screen back. 

By the way, you could save the macros you just merged. That way, you would 
only have to load one file in the future. Press 

[Airxri dJ CO 

and enter the name of the file in which you want to save your combined macros. 



Transparent Display Macros 



To make your display macros more efficient and easy to use, you can include a 
(TRANSP) symbol in a display macro. This convenient method allows the macro 
to be cleared when any key is pressed, and also "passes through" the keystroke to 
whatever application you're currently using. In other words, that keystroke is 
"transparent" to SuperKey. 

How might this come in handy? Suppose you have a display macro that dis- 
plays a menu of numbered selections. If you include the (TRANSP) symbol in 
that macro, a user could press the number for the menu item s/he wants. The 
menu would disappear (since the macro is cleared) and the selected menu item 
would appear on the screen. 

The (TRANSP) symbol can be placed anywhere in the display macro file after 
the dimensions of the display window. An example: 

<BEGDISP> <CtrlFl> 1, 1, 5D, ID. <TRANSP> 

Your distribution disk contains two macros that include the (TRANSP) 
feature— DOSTRNSP. MAC and 123TRNSP.MAC. These are the same as 
DOS. MAC and 123. MAC except that they are cleared when you press a key. 
Try them. 
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Enhanced Text 



The display macro window sports three different colors: one for the frame and 
two diflferent colors for the text. On a monochrome or B/W monitor, this trans- 
lates into different intensities. The actual colors or intensities vary; you can use 
them as they are, or you can use the installation program to choose other colors. 
See page 186. 

In any case, you select different colors by entering control characters into the 
text: Control-B's switch between the two text colors, and Control-D's switch the 
frame color on and off. 

You can either actually enter control characters (by pressing, for instance, 
I Ctrl ITbI . if your editor lets you, or type the symbols shown here. (WordStar won't 
let you enter the actual control characters, but Side Kick's Notepad will.) 

<CtrlB> for Control-B, and 

<CtrlD> for Control-D 

For example: 

<BEGDISP><Rltl>l,l,5D,5. 

This is normal text. 

<CtrlB>This is the secondary text color<CtrlB> 

<CtrlD>flnd this is the color of the franie<CtrlD> 

All <CtrlB>three<CtrlB> on <CtrlD>one<CtrlD> line 

You <CtrlD>can <CtrlB>even<CtrlB> nest<CtrlD> theni<ENDDEF> 

Now copy this example, save it in a file, and load it into SuperKey to see the 
effect on your screen. 



Titles and Auto-Start 



Finally, let's see how we can give the display macro a title, and how to make it 
autO-start. 

The trick is to use SuperKey symbols. You have already used a couple of 
symbols: <BEGDISP> to signal the start of the macro and <ENDDEF> to signal the 
end of it. Meet two more: 

<TITLE> is used to mark the beginning and end of a title 
<fiOTO> makes the macro autO-start 

Let's use both of these symbols in the DISP. MAC file we made before. Re- 
enter your editor and add the following to the end of the first line of the file: 

<TITLE>MoneyManager Instructions<TITLE><AaTO> 
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The text between the two (TITLE) labels is the title of the macro that shows 
up in the shoW titles window. Now the first line should look like this: 

<BEGDISP><filtFlD>EB,'^,3D,fi.<TITLE>MoneyManager Instructions<TITLE><AUTO> 

Save the file with these changes, load it into SuperKey, and watch what 
happens. 



Fields 



Macros can do more than just play back commands and display pretty screens. 
Suppose you want to copy a number of files from the logged disk to the B: drive. 
You could repeat this command for each file: 

COPY FILENAME B: Ei 

Let's make a macro do most of that for you; the only thing you'll have to enter 
each time is the file name. Let's start recording the command in Uit jT cli 

fAinrn {m} (T| fAinrci copy 

It would be silly to actually put the file name into the macro; then you would 
have to make a macro for each file you want to copy. SuperKey provides a way to 
let you enter the file name when you play back the macro. Afield will temporar- 
ily stop macro playback and let you type in something. When you press l-^-*! . the 
field is terminated, and the rest of the macro plays back. 

SuperKey has fields of either variable or fixed length. You'll want to use a 
variable field here, because a file name could be as short as one character, or as 
long as 14 (actually 64 including a file path). 

So, continue your I Ait Ifcl macro by pressing 

(Airxo (H (XI 



to start the variable field. Note the space, represented by a blank key, that sepa- 
rates the file name from the COPY command. Then press 

to end the field. The reason you have to both begin and end the variable field is 
that you could put something in between start and end to make the field do 
special things. We'll look into that on page 51. 

Continue with the rest of the COPY command. Again, note the space that 
separates the file name from the destination: 
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DOS will tell you it couldn't COPY a nonexistent file, but you can ignore that; 
this is all for the purpose of creating a macro, not for telling DOS anything — yet. 
Now, end the macro: 



then press I Ait I fcl to play back the macro. It will write COPY and then wait for 
you to enter a file name. Do that and press l-^-*! . The rest of the macro plays 
back, and your file is copied. 

More On Variable Fields 



Suppose you are writing letters to customers who have ordered various articles, 
informing them that the ordered item is now in stock: 

Dear Mrs. JoneS/ 

We are happy to inform you that the oven you 
ordered on May EQth has now arrived. 

The only things that would vary in this letter are the name, the article, the 
date, and the verb (which could be has or have). If you use a variable field, 
there's no need to write the entire text each time. Define a macro as follows: 

(AirjQ (Airj(T|Dear (ctriJQ {^HJf^ , £] 

We are happy to inform you that the rctFTiFl ["ctrflP] you 
ordered on I ctn IF H I ctri |P1 now arrived . 

rAiTY^ 



The first time you press I Ctrl f -l (hold down the I Ctrl | key and press Fl ). you 
mark the beginning oi a variable field. The next I Ctrl | F1 terminates it. 

Now press I Ait f O and watch what happens. Each time SuperKey meets a 
variable field, it pauses and lets you enter whatever you want. Terminate the 
entry with l-*-^l . and SuperKey resumes playback. 

If you "lose" characters on playback, it is probably because SuperKey 's play- 
back speed is too fast for your program. You can set a playback delay to reduce 
the speed (see page 155 for details). 
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Fixed Fields 



Instead of variable length fields, you can use fixed length fields. Fixed length 
fields can save you time when the data you enter is the same length. A fixed field 
does not require you to press l-^-*! : playback resumes as soon as you enter the last 
character in the field. This is useful for entering such data as item numbers, 
dates, etc. 

The following example records a month followed by a fixed two-character field 
for the day and, finally, the year: 



August- I Ctrl II ] I I I I i rcHim -iqas 

rAit)Fi 

As you can see, I ctn I Tl marks the beginning and end of the fixed field. The two 
spaces between define the length of the field: two spaces for two characters. Each 
time you press I Ait f ol. SuperKey plays back "August-", waits for you to enter the 
day, and then prints the year "-1985". 

You don't have to press l-^-*! to end the field. It ends automatically when filled. 
However, if you don't want to fill the entire field you can press l-^-*! to end it. 



Field Formats 

Field formats let you control the appearance of what you enter into a field. Vari- 
able and fixed fields alike let you define how numbers are formatted. 

In fixed fields only, you can also format your data as Left adjusted, Right 
adjusted, or Centered. 

You format a field simply by writing special characters between the beginning 
and end of a field. In order to use formatted fields, you must first switch on the 
Format fields option on the Options menu. Press 

(Airxri CO CO 

when the Format fields option is oflF during macro recording, none of what you 
enter between the start and the end of a field is recorded in macro memory. This 
is usually how you want it, but if you want to format fields, you must record the 
special format characters into the field. 

Field formats are described in full detail on page 119, but let's try a few simple 
formats now. First, we'll create a variable field which lets you enter a number 
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and then displays it with two decimal places and a comma for every third digit: 

{WJ=} (Air|T| 



If you want to use a macro to align columns of numbers, you will want them 
right-adjusted so the digits line up vertically. You do that by making a fixed field: 



Alt i = I I Alt M N I 

\ Ctrl i rT l ##,###,###.## I Ctrl IIT) 

Numeric formats are always right-adjusted in fixed fields. If you want to right- 
adjust text, enter an R as the first character when you define the field: 

This fixed field will be four characters wide (because of the four spaces). The R 
does not count in the width of the field. 




To center text in a fixed field, enter a C as the first character: 



Alt 
Ctrl 
Alt 


I 



M^ 



This field is six characters wide, and if you enter anything shorter than that, it 
will be centered over the six spaces. 

Note that you cannot mix formatted numbers with text within one field, but 
you can have two or more fields right next to each other — some fields for text and 
some for numbers. 



Entry Control 

SuperKey also lets you control the type of data you can enter into variable and 
fixed fields, again simply by including special characters — an entry mask — 
between the field delimiters (beginning and end of the field). You can use an 
entry mask to specify any of the following: 

• Numeric only 

• Uppercase alphabetic (convert lowercase to upper) 

• Lowercase alphabetic (convert uppercase to lower) 

• Alphabetic 

• Any character 
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Again, the Field formats option (on the Options menu) must be ON to use 
entry masks. In the example under Field Formats, the #'s (apart from describing 
the format), limit the field to numbers only; any other characters you try to enter 
are ignored. Press I Ait IT nI and enter 

153x<5t.?y ei 

The letters are ignored; what you should see on the screen is 

123,^5t.?a 

If you want to make sure that numbers are entered in certain positions in a 
field, you can use an N in the entry mask. The fixed field below accepts only 
numbers in the first three positions, and any other characters in the remain- 
ing five: 

{^j^ NNN CJ c::^ c^ c:;^ {^;ji (ctHjirj 

Note that you must enter a space before and after the iVs. Let's define a ten- 
character fixed field which will let you enter a name. We want to force the first 
character to uppercase (by entering a U), and all following characters to lower- 
case (by entering nine Ls). 



My first name is (ctr[](T| ULLLLLLLLL (WjlTI 
fAitlFl 

Notice that this macro definition uses the same key, I Alt |f ¥l. as you used in the 
example with numbers above. This means that the old macro will be replaced by 
the new one. (SuperKey will warn you that you are about to erase a macro.) 

Now press (AjtJTJ. SuperKey plays back the text My first name is, and then 
waits for you to type. Enter your name in all lowercase letters, for example: 

John S) 

The following will appear on the screen: 

John 

no matter which combination of upper and lowercase letters you type. 

Try different combinations of upper and lowercase letters, and try to include 
numbers or other non-alphabetic characters. Each time SuperKey will show the 
name in the specified format. 

In a variable field, the last entry control character determines what you can 
enter into the rest of the field. The variable field below will translate a lowercase 
letter to uppercase for the^rs^ character and vice-versa for all following charac- 
ters. 

(ctrf|^ (TJ (T| [ctHJ^ 

Entry control is described in more detail on page 114. 
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Nested Macro Recording 



The COPY macro you made on page 50, using a variable field, saves you some 
typing when you copy files. But suppose you want to delete each original file 
once it is copied, like this: 

COPY FILENAME A: 
ERASE FILENAME 

This macro would do the trick, of course: 

cqpy T IJAJtil/ I 1 M I ITI fAinrn llil jTI I \ r: (^ 

ERASE r^ I Alt 1 / ITilTvl I Alt i| / ITmITvI £] 

rAitirniMTrEi 



but then you would have to enter the file name twice. So instead of using a 
variable field, record the file name in another macro, and then use this macro in 
the ERASE command: 

[Ainrn fmi m fAinrci 

c.ovy T ^mti I Tmi (TJ fcurpiol (AFjITJ [Mj (TJ I I a: ei 

ERASE I 1 ICtfliFIOj ^ 

rAiniTlTMT(TP 



when you play back this macro, it will type COPY, then stop for you to enter 
the file name and press l-^l . When you do that, the file name is recorded in the 
macro rctrTj fio | . which is then in turn used by the ERASE command. 

We call this nested macro recording because you record one macro while you 
play back another. I Ctrl | fio t js chosen arbitrarily; it could be any key or key combi- 
nation. We chose an out-of-the-way key combination because it is not a macro 
you will use directly; it's just there to hold the file name for the ERASE command. 
(If you know about programming, you'll see that ("ctiTllFioi is actually used as a 
variable.) 



The Macro Editor 



Until now you have defined all your macros interactively, that is; while you were 
actually working with your application program. This is very convenient for 
many macros, especially because it lets you see what the macro actually does, 
right then and there. 

However, if you want to design a very long and complicated macro, or if you 
want to make changes to an already defined macro, an interactive definition 
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could be very tedious. SuperKey, therefore, has another way to define and edit 
macros: the macro eDitor. Press 



SXTKUdJ 

to activate the eDitor. Now press the key that holds the macro you want to edit. 
If that key already holds a macro, you will see it displayed on the screen below 
the macro editor's status line. Otherwise the screen will be blank, ready for your 
entry. 

Figure 5-1 shows the status line. The status line is discussed in detail on page 
101. The three things you need to know right now are: 

• the symbol on the far left shows you the key you are editing 

• the arrow keys Q and Q are used to move around 

• you press I Alt | Esc j to exit the editor 



lev: t& Iisert Fl -4tel» AltESC -txit flltC -Com fllU HIove 

CTlTUP BorUni ilowi KrillPU ive la difrerence! 



Figure 5-1 Macro Editor 
Write A Macro 

Now enter this text (speUing errors and all) and press l-^l . 

This i a samble macro El 

Something unexpected happened, right? The cursor did not move down a line 
when you pressed l-^l . Instead, you got the symbol 

<ENTER> 

Many of the keys on the keyboard don't normally produce printable charac- 
ters — they have some other effect. When you press I Esc I . for example, you don't 
get anything on the screen, but your program reacts to it in its own way. 

In the macro editor, however, we want to see the lEscj and all other keys that 
normally don't show. SuperKey displays these keys as symbols — descriptive text 
enclosed in angle brackets: 

dO is (ESC) 
O is (TAB) 
(PgUp) is (PGUP) 
S is (ENTER) 
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and so on. There is a full listing of key symbols on page 135. If you want to insert 
arrow key symbols in a macro, you must first press the sKip key, then the arrow 
key. This is because the arrow keys are used to move around in the editor. For 
instance, to insert a right arrow key symbol (RGT), press Q Q. 

Edit The Macro 



Remember the spelling errors in the text you typed in? Now we're going to use 
them to show you how to edit a macro. 

Press Q to move the cursor back to the space right after the i. It should have 
said is, so enter an s here. Now move the cursor to the b in samble. That should 
have read sample, of course, so you want to put a p where the b is. You can either 
press (2£U to delete the b and then insert the p. Or you can first press [["0 to 
switch from Insert mode to Overwrite mode. Notice the change on the status 
line at the top of the screen. Now enter the P on top of the b. Press [jnsj again to 
switch back to Insert mode. 

The Main Menu 



Even though you are in the macro editor, you can still use SuperKey's main 
menu to enter commands. That is, the commands you enter via the menu show 
up as symbols when you look at the macro in the macro editor. This is faster than 
typing in all the characters and angle brackets yourself It also shows you what 
the symbols look like, so you can create and edit the file later with your own text 
editor. 

Let's give the sample macro a title, for instance, sample. Press 

(Ayr] 

as usual to call up the main menu. Then press 

(1](T| 

and type sample. When you return to the editor, you'll see this: 

<TITLE> sample <TITLE> 

This symbol does not represent a key on the keyboard, but a SuperKey com- 
mand. Other examples of command symbols are: 

<CMD> for functions 

<VFLD> for variable fields 

<FFLD> for fixed fields 

You'll find a complete list of command symbols on page 137. 
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End Edit 

To end editing and record the macro, press 

fAinrEsci 



You are then asked if you want to save your changes. Press (^ to save. (^ 
would exit the editor without recording the macro. 



Using a Text Editor to Edit Macros 



There is a Hmit to what the macro editor can do. First of all, it is limited to 
macros that will fit on the screen. Secondly, it only lets you see one macro at a 
time. 

If you have very long macros, or want to see all your macros at the same time, 
you must use your normal text editor to edit macros. You can use any editor that 
reads and writes standard ASCII text files, such as EDLIN, WordStar (in non- 
document mode), SideKick's Notepad, or the Turbo Pascal editor. 

Any macros you want to edit must first be written to a file with the Save 
macros command (on the macros menu). 

To edit the macros, simply load this file into your editor. It contains all the 
macros that were in macro memory when you saved, in the order in which they 
were recorded. 

Each macro begins with the symbol <BEGDEF> (or, for display macros 
<BEGDISP>) and ends with the symbol <ENDDEF> 

Anything entered in between those symbols appears the same in the macro 
editor. When editing macros this way, of course, you should be very careful to 
get everything right, especially the symbols. Look at other macros and see how 
symbols are used. If you make any mistakes, SuperKey will tell you so when you 
try to load the file. 

Important. Be careful not to disturb the <BEGDEF> and <ENDDEF> symbols. 
Each macro must start with <BEGDEF> and end with <ENDDEF>. 
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6 



The Layout Editor 



The layout editor is used to create or alter keyboard layout files. This SuperKey 
feature can really come in handy if you don't like where some of your keys are 
located. Enter the layout editor by typing 

LAYOUT e) 

on the DOS command line. The program will ask you for the name of a layout 
file. If you enter the name of an existing file, this file will be read in; otherwise, a 
new file will be created. The file name can be any legal name, and if you don't 
enter a last name, the last name . LAY will automatically be chosen. 

The editor then shows you the picture of two keyboards, shown in Figure 6-1. 
The keys in the top picture are organized as they are on your actual keyboard. 
This is a reference to your physical keyboard, and it never changes. 

The bottom picture shows the new key positions. This is your keyboard as it 
will appear when you load the layout file into SuperKey. The keys in this picture 
will change positions as you edit them. 
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Figure 6-1 Layout Editor 

Changing a key position is simple: 

• Use the arrow keys to move the cursor to a key on the upper keyboard that you 
want to "relocate." 



• Press I I (the space bar) to select the key. The cursor now jumps to the 
lower keyboard. 

• Use the arrow keys to move the cursor to the position where you want the key 
to be. 

• Press I I again to position the key. You'll see that the key name changes. 

The cursor then jumps back to the upper keyboard, and you can repeat the 
process with another key. 

Note that you move one key at a time, so if you want to swap two keys, you 
must first move one, then the other. 

Let's look at an example. We'll switch the left hand \o\ key and the {\}. This 
eliminates one of the most frequent complaints about the standard IBM PC 
keyboard: its shift key is in the wrong place. 

First move the cursor to the left hand 1-^ i key on the upper keyboard and 
Then move the cursor to the (^ key on the lower keyboard and 
. That puts l-^l on the Q key. But since nothing is yet moved onto 



press 
press 
the 1-^ i key, you have two of them for the moment. 

Now select the [XI key on the upper keyboard, press 
leftmost l-^l key on the lower keyboard, and press 

Voila! Your keys are where you want them. 



move to the 



agam. 
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Finally, press IF2 | to save your new layout; the .LAY filename extension is 
added automatically. If you change your mind and want to leave the layout editor 
without saving your work, just press I Esc I . 

To use a layout you create with the layout editor, you must load it. Press 

and enter the name of the layout file you want to load. This file must be on the 
same disk and directory as your macro files. It is normally the logged drive/active 
directory, but if you have defined another location in the Setup, your layout files 
must be there. 

It's likely you'll want to use your new keyboard layout all the time. In that 
case, you can use command line parameters to load the new layout automatically 
when you load SuperKey. For example, to load a layout file called NEW. LAY, 
you would start SuperKey by typing the following on the DOS command line: 

KEY NEW/LL £] 

Of course, you can also use an AUTOEXEC.BAT file to load both SuperKey 
and the new layout automatically when you turn on your computer. See Appen- 
dix B. 
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7 



Reference to SuperKey 



This chapter provides, in alphabetical order, complete information about all 
commands, features, and concepts associated with SuperKey. Use this chapter as 
a handy reference whenever you need it. 

For each command or feature, the following information is given: 

• How to invoke the command: what keys to press or what to type on the DOS 
command line (if applicable). 

• Default value: SuperKey factory settings. 

• Complete description. 

• Example using both "hot keys" and DOS commands. 

• Cross reference to other commands and features. 

Some of the information in this chapter is collected in the SuperKey help 
system which you use by pressing 

[ED 

whenever SuperKey is loaded, provided the help file KEY.HLP is on the disk 
and/or directory where the SuperKey program is located. 
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Arrow Key Defaults 



Press 



Ain rri (^ (TJ (or use /DR parameter on DOS command line) 



Default values 






Description 



The default value for the four alternate arrow keys (see page 66 for definition) are 
|F7 I through I F10 i . but you can choose any other definable keys you like. Activate 
the main menu (press [Ait f Tj), then select Defaults, and finally select Arrow 
keys. A small window opens showing which four keys are currently selected as 
alternate arrow keys. You can enter four other keys by pressing the desired keys. 
The first key you define is the alternate Q^ key. When you've done that, you 
automatically move to the Q, and so on. Even if you want to change only the last 
alternate arrow key, Q you must define the three others. You can press lEsc| any 
time to close the window. 



(Ucrox CommWs Functtoiis Opiio»s 



Iw:F«|ptioa Layoat Setap 



Alt' 
Alt' 
Alt- 
Alt/- 
Ctrl] 
Ctrl- 



Icflia Bacro 

Title 

aatO-start 

Ib4 Bacm 

lleaa 

rixeJ fieU 

Uar f ieU 

cut aa4 paite Alt! 

keCia klock I 

slip aacro 

atoF 

tkoy titlea 

Coaaaai atack 

leciaal polat 

icLiaiter 

Fill cHaracter <SPACD 
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mmsm 



CtFlESC 

AitriT 

Alt\ 



Up amM 



Left arrow 
miht arrow 



Figure 7-1 Alternate Arrow Key Definition Window 
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Example 

To use the control characters CtrlE, CtrlX, CtrlS, and CtrlD (the "WordStar 
diamond") as alternate arrow keys, press 

r^nrn rn rri rct?rrn fct?rrin [Wfsi [wi^ 



to automatically load the new defaults along with SuperKey. Start SuperKey 
with this command: 

KEY /DAECtrlE] [CtrlX] [CtrlS] [CtrlD] 



See Also 



Arrow keys option 

Defaults 

Save defaults 
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Arrow Keys Option 



Press 
I Alt f r\ [T| {T^ (or use /OR parameter on DOS command line) 



Default value 



OFF 



Description 



When you press IKS I to activate the numbers on the numeric keypad, its cursor- 
movement arrows are no longer accessible (unless you press 1-^ 1 ). This can be 
inconvenient, since you often want the numbers and the arrows to be active at 
the same time, notably in a spreadsheet. 

SuperKey therefore lets you use four other keys as [^, Q, Q, and Q. They 
are only active when I VZ \ is active, rendering the normal arrow keys useless. 

When you first start SuperKey, the alternate arrow keys, although defined, 
are not active. You activate them by opening the Options window on the main 
menu, then selecting Arrow keys. You can also press [+} or Q to explicitly turn 
the alternate arrows ON or OFF. 

The default values for the alternate arrow keys are 
but you can choose to use other keys by changing the default (see page 64). 



Examples 



Use the following keystrokes to toggle the alternate arrow keys ON: 

(Ajr^O (T| Q HO 

or start SuperKey with this command: 

KEY /oa+ 
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You can also make a macro that toggles the status of the alternate arrow keys. 
Let's use I Ait I Tl: press: 



IWtJL^ lAltjAj 

rAiTIF- 



See Also 



Arrow key defaults 

Options 

Save options 
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Autostart Macro 



Press 



Description 



A macro can be made to start automatically each time the macro file is loaded or 
merged into memory. This is useful for displaying help text or menus, or for 
starting self-running demos or tutorials. 

To make an auto-start macro, first activate the main menu: press I Ait f T\. Then 
select auto-start on the Macros menu. 

There can only be one auto-start macro in memory at one time. If there's 
already another in memory, it will lose its auto-start status. 



Example 



To make I Ait |fi | start automatically each time the file containing it is loaded or 
merged into memory, enter 

laa laiiD SQ SI CD 

: (The body of the macro is entered here.) 

lAJt 



See Also 



Load macro 
Merge macro 
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Beep Function 



Press 

(afjt;! (Tj|(T| 

Description 



Beep is a function that can be included in a macro. When the macro is played 
back, a sound is generated. 



The beep function is entered while you are recording a macro. Press I Alt f Tj. 
select Functions, then select Beep. The small window shown in Figure 7-2 
opens. You must now define the start and end frequencies and the duration of the 
tone. Finally, press l-*^l to record the beep. 



nv: <H> Text- rress <*lt-> to mt. 



lUcfiw C o— iKi l 



OrtioB 



lefaalts Encri^rtioa Uwoat Setup 



ikim \ 

OIS^Hr~— tEFINI BEEl 
Clur tclStirt (Hz): 2868 

•eUv ttltui (Hz): sea 

levkoaWlTiu (1/188): 288 
laa«i*' 

ratk 

leal till iaUv 
Screea off 
Oa 



Figure 7-2 Define Beep Window 



Example 



If you enter: 

you will get a tone that starts at 400 Hz, ends at 500 Hz, and lasts for one quarter 
of a second. 

If you look at this macro in the editor, it appears as follows: 

<CMD>FBDD<DD DD5D0 DDDa5<CMD> 

with the I Alt i n command symbolized by (CMD). 
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Begin Block Default 



Press 
I Alt f Tl (T| [T| (or use /DG parameter on DOS command line) 



Default value 



Description 



The begin block command is used to mark the beginning of a block to cut and 
paste. You can change its default value from [^ to any other definable key(s). You 
might want to do this if your word processing program uses a diflFerent key to 
begin a block. It's easier to only have to remember one command. 



Example 



If you want to use I Alt | Home I to begin a block, press 

[MTH IT! ("Gl fAi nib^ 
or start SuperKey with this command: 

KEY /DGCRltHome] 



See also 



Cut and paste function 

Defaults 

Functions Menu 
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Begin Macro 



Press 



I Alt f ^ (can be redefined, see page 90) or 



Description 



The Begin macro command is used to define a SuperKey macro. When you press 
the keys above, a small window opens and requests you to press the key you 
want to hold the macro. 

After you press the key you want to define, a line appears at the top of the 
screen, informing you that you may now enter your macro. Anything you type 
now will be sent to SuperKey's macro memory as well as to your application 
program. SuperKey is thus totally "transparent" to your application program. 
This method of defining a macro is called interactive, since it takes place while 
you are working with your application program. 

If your other program also uses the top line of the screen, you can move 
SuperKey's message to the bottom of the screen with the command 

While you record a macro, you can use the following commands: 

I Ctrl I FI Start and end a variable field (see page 175). 

rctrTim Start and end a fixed field (see page 125). 

I Alt I FI End the macro recording (see page 123). 

Press I Alt f Fj to access the main menu. You can now include functions in the 
macro by selecting from the Functions pull-down menu, or you can let the macro 
change Options or Defaults by selecting items from these menus. You can even 
load or merge other macro files by selecting from the Macros menu. In fact, you 
can do almost anything you normally do with the main menu, and it will become 
part of the macro you are defining. 
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Examples 



To make I Ait ifin send the message if i, fin a macro each time you press it, type 
the following: 

Hi, I'm a macro 

Let's make a macro that first defines another macro and then uses this macro for 
further processing. For example, here is a macro that asks for a file name, then 
copies this file to drive B:, and finally erases the original file: 



(AitJ[^ (Aitj[cj Enter file name: 
(AiTX^ (ctrf][?i^ (AiTX^ ^ 
COPY [ctriJIio] B: 1^ 
ERfiSE fct?iTFio1 P^ 



More examples of functions and options used in macros can be found in the 
sections discussing each separate feature. 



See Also 



Editor 
End macro 
Fixed field 
Functions 
Macro memory 
Main menu 
Titles 
Variable field 
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Bottom Line Option 



Press 

("Ain rn (TJ (TJ (or use /OB parameter on DOS command line) 



Default value 



OFF 
Description 



The Bottom line option selects the position of the message that SuperKey dis- 
plays while you record a macro interactively. It is normally at the top of the 
screen, but can be moved to the bottom if the normal position interferes with 
other programs. 

Switching this option ON moves the line to the bottom line of the screen. 



Example 



Use the following keystrokes to move the line to the bottom of the screen: 

or start SuperKey with this command: 
KEY /OB + 



Or, you can use a macro to toggle the position of the line. Let's use I Alt M T" 
Press 



|Alt J =J|Alt J jJ 

(AirxGdJd] 



See Also 



Options 
Save options 
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clear Macros 



Press 



Description 



The clear macros command erases all macros from macro memory. The keyboard 
is now back to normal, but SuperKey is still active, and you can make new 
macros. It is not necessary to use the Clear macros command if you are loading 
a new macro file, because loading new macros automatically erases the ones that 
were in memory before. 

Remember to save your macros before clearing memory if you want to use 
them again. 

Clear macros does not afiect keyboard layout; if you have an alternate layout 
loaded, it is still in eflPect. 



Clear A Single Macro 

If you just want to clear a single key of its macro, simply reassign the key to its 
original meaning. To clear, for example I Ait if Dl. press 

See Also 



Save macros 
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Clear Keyboard Layout 



Press 
Description 



The clear layout command returns the keyboard to its original configuration if 
you have loaded an alternate layout. SuperKey is still active, and any macros in 
memory are not affected. 



Reference to SuperKey 75 



Ckar Screen Function 



Press 

(AirXO(T|(TJ 

Description 



Clear screen is a function that can be included in a macro. When the macro is 
played back, the screen is cleared and the cursor is placed in the upper left-hand 
corner. 

To enter a clear screen function into a macro, first activate the main menu by 
pressing I Alt j Tj. Now select Functions, then Clear Screen. 

A cleared screen cannot be restored. Instead, you can use the screen ofiF/on 
function to blank the screen and restore it again — a very useful precaution 
against prying eyes. The protect delay option will switch off your screen after a 
pre-set time, and switch it back on again when you touch a predefined key. 



Example 



To make I c<i"i If cl clear the screen, enter: 

If you look at this macro in the editor, it looks like this: 

<CHD>FC<CMD> 
where the rAitT Tl command is symbolized by <CMD>. 



See Also 



Functions 
Protect delay 
Screen off function 
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Command Line Parameters 



Description 



Command line parameters can be used to pass commands to SuperKey when 
you load it, (and after you load it, if you wish). The same commands can be given 
via the main menu, once SuperKey is active, but parameters provide a conve- 
nient way to control SuperKey from .BAT files, which is especially useful if the 
computer operator does not know SuperKey. 

Parameters are one or two letters initiated by a slash: /; some are preceded by 
a file name, and some are followed by additional information. The way to specify 
each parameter is listed later in this section. 

Parameters can be passed not only on the first call (that is, when you load 
SuperKey), but also later when SuperKey is already loaded. Suppose you start 
SuperKey with the following command: 

KEY WS/ML DVORRK/LL /OT+ID /DMLCtrlM 
This command will: 

• load SuperKey into memory 

• load the macro definition file WS.MAC 

• load an alternate keyboard layout from the file DVORAK. LAY 

• set the save screen protect delay to 10 minutes 

• redefine the main menu key from I Alt f fj to I Ctrl iTxl 

SuperKey is now resident in memory, and subsequent attempts to load it 
again will fail, but parameters can be passed on. After loading SuperKey as 
above, you may want to use a different set of macros and the standard keyboard 
layout. Of course, you could use the main menu, but you could also let a . BAT 
file do it automatically: 

KEY DOS/ML /LC 
This command will: 

• attempt to load SuperKey into memory, but since it is already there, it is not 
loaded again 

• load the macro definition file DOS. MAC 

• clear the alternate keyboard layout and return the keyboard to normal 
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Parameter Syntax 



Table 7-1 lists all command line parameters, their syntax, and their use. Note 
that you must always type KEY before any command line parameter. Some 
words have special meanings in the table: 

FileName a file name 

Number a number 

{ + I — } either + or — 

[symbol] a key symbol (see page 134) 

Note that square brackets [ and ] are used instead of angle brackets < and > to 
enclose key symbols on the command line. This is because DOS uses < and > 
for "pipe" commands. 

Parameters must be separated by spaces or commas. The following command 
lines are equivalent: 

KEY DBASE/ML /0W+ /DA [CtrlE] ECtrlX] [CtrlS] tCtrlD] 
KEY DBASE/ML, /0H+, /DA [CtrlE] , [CtrlX] , [CtrlS] , [CtrlD] 



Example 



Suppose you want to use SuperKey only in your word processor and in your 
spreadsheet. You have a separate macro file for each of these programs, and you 
want everything done automatically. Just make the following two .BAT files: 

WP.BAT: 

KEY HS/ML /OD- 

WS 

KEY /0D+ 

CALC.BAT: 

KEY 153/ML /OD- 

LOTDS 

KEY /0D+ 

These .BAT files will load SuperKey and pass parameters to it (or, if it's already 
loaded, just pass the parameters). The parameters will load the appropriate 
macro definition file and then turn suspension OFF, that is, activate SuperKey. 
The program is then started, and when you return to DOS, SuperKey is called 
with a parameter that turns suspension ON and SuperKey becomes inactive. 
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Table 7-1 Command Line Parameter Syntax 





Syntax 


Use 




/DA [symbols] 


Change default alternate Arrow keys 




/DB [symbol] 


Change default Begin macro key 




/DC [symbol] 


Change default Command stack key 




/DD [symbol] 


Change default Decimal point 




/DE [symbol] 


Change default End macro key 




/DF [symbol] 


Change default Fixed field key 




/DC [symbol] 


Change default beCin block key 




/DK [symbol] 


Change default sKip macro key 




/DL [symbol] 


Change default deLimiter 




/DM [symbol] 


Change default Menu key 




/DP [symbol] 


Change default stoP key 




/DU [symbol] 


Default cUt and paste 




/DV [symbol] 


Change default Var field key 




/DW [symbol] 


Change default shoW titles key 




/K 


Kill SuperKey 




/LC 


Clear keyboard layout 


FileName 


/LL 


Load keyboard layout 




/MC 


Clear macros 


FileName 


/ML 


Load macros 


FileName 


/MM 


Merge macros 


FileName 


/MS 


Save macros 




/OA{ + |-} 


alternate Arrow keys option 




/OK { + 1 - } 


Keyboard click option 




/OC { + 1 - } 


Command stack option 




/OO { + 1 - } 


One finger mode option 




/OP Number 


Playback delay option 




/OR Number 


Real time delay option 




/OT { + 1 - } 


proTect screen ON/OFF option 




/OT Number 


proTect screen delay option 




/OU { + 1 - } 


sUspend option 




/ow { + 1 - } 


disk Wait option 
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Command Stack 



Press 



fAirTNl (can be redefined, see page 90) 

or (wrxD d] dJ 



Description 



The Command stack is a small part of your computer's memory that SuperKey 
sets aside for the last 256 characters you have entered on the DOS command 
line. You can execute a command from the stack just by selecting it and pressing 
l-^i : no need to re-enter long commands repeatedly. This feature is similar to the 
way the |F3 | key works in DOS; but |F3 \ remembers only the last command, 
whereas the command stack remembers as many commands as will fit into 256 
characters. 



You access the command stack by pressing 

fAFYV 



The entire stack is displayed in a window, with each command on a separate 
line; commands are listed in reverse order, with the most recent command on 
top. Select the command you want to execute again by moving to it with the Q 
and Q keys, then press l-^-^l . The command is sent as if you had typed it all over 
again, and it is put on top of the stack. To leave the command stack, press I Esc t . 

If you like, you can edit a command before pressing l-^i to re-execute it. The 
Q and Q keys move right and left on the line, and (oeij deletes the character 
under the cursor. 

The command stack can be switched off and on as explained on page 82. 
Example 



Suppose you are developing a program in assembly language and want the final 
result to be a .COM file. You will be repeatedly editing, assembling, linking, and 
EXE2BIN'ing your program using commands like these: 

WS INVADERl.flSM 

ASM INVADERl; 

LINK INVADER1+\0BJ\INVM0D1+\0BJ\ 

INVM0D5, INVADER, INVADERl; 

EXESBIN INVADER.EXE \COM\INVADER.COM 
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when this process is completed, you test your new program and find an error. 
Back to the editor, correct the error — and now you must type the whole mumbo- 
jumbo all over again, without error! Not so with SuperKey. You just press 
I Alt rV) . move the bar to the desired command, and press I'^-'l . 



See Also 



Command stack option 
Defliults 
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Command Stack Option 



Press 

I Alt fT~^ IT) (TJ (or use /OC parameter on DOS command line) 



Default value 



ON 



Description 



The command stack is normally active, which means that anything you type on 
the DOS command line is continuously recorded on the stack. You can switch oflp 
the stack to stop recording; when you later switch the stack back on, it contains 
whatever was in it when you switched it off. When the command stack is OFF, 
you can still use the commands that were previously recorded in the stack. 

To switch the stack OFF and ON, select Options on the main menu, then 
Command stack on the pull-down menu. Press l^^i to toggle the status to the 
opposite of its current value (OFF if it's ON and ON if it's OFF), or you can press 
[+] or Q to explicitly turn the stack ON or OFF. 



Examples 



Use the following keystrokes to turn OFF the command stack: 

SXD O CO (T| Q (liTJ 

or start SuperKey with this command: 

KEY /OC- 
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You can let a macro toggle the command stack status each time you press a key. 
Let's use I Ait f Ml: press 

(Airj^(AirxMj(Ai^ 
See Also 



Command stack 
Options 
Save options 
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Cut and Faste 



Press 



I Alt IT) (can be redefined, see page 90) 

nr fAirrn rMirin 



Description 



The cut and paste command allows you to pick up anything displayed on the 
screen and put it into a macro. This command can be used to move data from one 
program to another. 

After you press I Ait f T\. press the key you want to hold the cutting. SuperKey's 
windows then disappear from the screen, and it looks as if you are back in your 
program — but you aren't. All you can do at this point is move the cursor around 
on the screen with the arrow keys and mark a block, which will then be "cut" 
from the screen and read into the macro. The maximum size of a block is one 
screen. 

First, move the cursor to the first character of the block you want to put into 
the macro and press (J^ for Begin block. Then move the cursor to the end of the 
block. You will see the block being marked as you move along. Now press l-^-*! to 
end the block and read it into the macro. 

To paste the block somewhere else, simply press the key that holds the 
cutting. 

If you want to redefine the beginning of the block, press (^ again. The current 
cursor position will then become the start of the block. 

The block you mark can be anything from a single character to the entire 
screen. The begin and end block markers define the upper left and lower right 
corners of a rectangular block. 

If a block contains more than one line, a carriage return will be inserted at the 
end of each line when it is read into the macro. 
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Example 



•rter VIM rr*u ALT I. frms tW l>« VM Mit U koll tk« 
oiitlMf. Safsrlay's HiWimm thaa ils«pf«ar ffroa tka icrveBa tml 
it ■•oki u if 9n «M Uck la «■» ffofrMi, Wit ^m un't. «ll 



irst, aov/e the cursor to the first 
lilt to put into the aicro 41 



cter or the blocli >)m 
or Begin hloclt. Then 
Kill see the hiocli 



Figure 7-3 Block Marked For Reading 



You need to include the latest sales figures from your spreadsheet in a report you 
are preparing with your text editor. Activate the spreadsheet and get the figures 
you want on the screen. Then press 

to read data from the screen into I Ctrl f Nl. Use the arrow keys to move the cursor 
to the upper left corner of the block you want to copy and press [^, then move 
the cursor to the lower right corner of the block. 

Now press l-^i to read the block into I Ctrl If Nl. Exit the spreadsheet and acti- 
vate your word processor. Place the cursor where you want the upper left corner 
of the block and press I Ctrl f Nl. 

If your word processor's margins are set too narrow for the block that is being 
pasted in, you may get some unwanted effects from automatic word wrap. Please 
be sure to check your margins. 



See Also 



Begin macro 

Cut and paste function 

Edit macro 
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Cut and Paste Function 



Press 

(AiTXri (TJ (T| 



Description 



Cut and paste is a function that can be included in a macro. It lets you make a 
macro pick up anything displayed on the screen. 

It differs from the cut and paste feature described on page 84 because it is 
included in a macro. When the macro is played back, you first mark a block of 
text or numbers on the screen. 

You mark the upper left corner of the block with the begin block marker ((^ 
by default). Then you move to the lower right corner with the arrow keys, and 
end the block by pressing l-^i . 

When you press the l-^-*! key, the marked block is moved to where the cursor 
was when you pressed the macro key(s). 

See Also 



Functions 
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Date function 

Press 

(AJTHilTKTI 



Description 



Date is a function that can be included in a macro. When the macro is played 
back, the date is read from DOS and transmitted to the application as a string of 
characters, usually in the following format: 

HM/DD/YYYY 

To enter a date function into a macro, press I Ait f Tj. then select Functions, 
then dAte. 



Example 



To make I Ait IT dI display the date, enter 

(AfrXTj (T| (T| 

Caoq 

If you look at this macro in the macro editor, it looks like this: 
<CHD>Fa<CMD> 
with the I Alt i f/"! command symboHzed by <CMD>. 



See Also 



Functions 
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Decimal Point Default 



Press 



AJQ^ (TJ (^ (or use /DD parameter on DOS command line) 



Default value 



Description 



The Decimal point we're talking about here is the character used to separate the 
integer part from the decimal part of a number that you enter into a formatted 
fixed or variable field. The format mask (see page 119) determines where in the 
field the decimal point is placed. 

The decimal point is normally a period, but you can select any other display- 
able character. Press I Ait IT") to activate the main menu, then select Defaults, 
then Decimal point. The current value of the decimal point is displayed to the 
right of the text, and you can now enter any other character you want to use. 
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Figure 7-4 Decimal Point Definition 
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Example 

If you want to use a comma as a decimal point, press 

(Ayu di CLi □ 

or start SuperKey with this command: 

KEY /DD, 

See Also 



Defaults 

Delimiter default 
Entry control 
Save defaults 
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Defaults 



Description 



Defaults are keystroke values assumed by SuperKey when nothing else is speci- 
fied. A number of SuperKey 's default values can be changed by activating the 
Defaults pull-down menu from the main menu: first press I Alt f Tl. then [^. You 
can now move the bar up and down in the window and select an item by pressing 
l-<-^l - or by pressing the capital letter in the name. Once you have selected an 
item, you can replace the current value by pressing the desired key or key com- 
bination; don't try to type in the name of the key(s). 
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Figure 7-5 Defaults Menu 



Default values can be changed when you first start SuperKey. Each parameter 
on the command line must be followed by the symbol of the desired key, using 
the symbols listed on page 136. See page 77 for how to use command line param- 
eters. 

If you want to make the new default values permanent, you can save your 
defaults by pressing 

(AOLIdjiU 

Table 7-2 lists all default values that can be changed either on the Defaults 
menu or with a command line parameter. 
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Table 7-2 List of Installable Defaults 





Parameter 


Default key(s) 


Begin macro 


/DB 


SlQ 


Title 


/DT 


(AUJ^ 


autO-start 


/DO 


L^LQ 


End macro 


/DE 


LailQ 


Menu 


/DM 


(aijt;! 


Fixed field 


/DF 


lOrlJT] 


Var field 


/DV 


LctrJQ 


cUt and paste 


/DU 


tAlJT) 


beGin block 


/DG 


(U 


sKip macro 


/DK 


□ 


stoP 


/DP 
/DT 


1 Ctrl 1 Esc i 


shoW titles 


1 Alt 1 PrtSc 1 


Command stack 


/DC 


lAltXJ 


Decimal point 


/DD 


□ 


deLimiter 


/DL 


□ 


fill cHaracter 


/DH 


( • 1 


help sYstem 


/DY 


[fLl 


Arrow keys 


/DA 


|F7 IIF8 IIF9 llFIOj 


Save defaults 


/DS 


{MJT} {0} {S} 



Example 



To change the stop Playback command from fctrriEsci to I Alt f Pl. press 

or start SuperKey with this command: 

KEY /DPCAltl] 
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Delay Function 



Press 
Description 



Delay is a function that can be included in a macro. When the macro is played 
back, playback pauses for the time given by the delay. 



To enter a Delay into a macro, first press I Ait f Ji. select Functions, then 
Delay. A small window opens, requesting you to enter the length of the delay. 
You can enter a number from 1 through 999. The number you specify is not 
exactly a time. Rather, it defines how many times a program checks the keyboard 
status. The actual delay time therefore varies depending on which program is 
running. If you want to specify an actual time delay, use the Real Time delay 
function. 
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Figure 7-6 Set Delay 
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Example 



To make I Ctrl | Home | go to the top of the document (in WordStar), then pause, and 
finally go back where you were, enter the following: 



Rqq e) 



If you look at this macro in the macro editor, it appears as follows: 

<CtrlQ><CtrlR><CMD>FDqRq<CMD><CtrlQ><CtrlP> 




See Also 



Functions 
Real time delay 
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Delimiter Default 



Press 

I Alt f Tj (T| (TJ (or use /DL parameter on DOS command line) 



Default value 



Description 



The delimiter we're talking about here is the character used to separate groups of 
digits in a formatted fixed or variable field. 

The delimiter is a comma by default, but you can select any other displayable 
character you want to use. Press I Alt MTl to activate the main menu, then select 
Defaults, and finally select delimiter. The current value of the delimiter is dis- 
played to the right of the text, and you can now enter any other character you 
want to use. 
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Figure 7-7 Delimiter Definition 
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Example 

If you want to use a period as delimiter, press 

(AJTXO (I] Q □ 
or start SuperKey with this command: 

KEY /DL. 

See Also 



Decimal point 
Defaults 
Field formats 
Save defaults 
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Disk Wait Option 



Press 

I Alt jfTj fTj rw| (or use /OW parameter on DOS command line) 



Default value 



OFF 



Description 



A computer program can do only one thing at a time, so while a program is 
reading or writing on the disk, it cannot receive characters you are typing. Your 
computer therefore has a keyboard buffer, a small part of its memory where it 
stores the characters it receives, whether they are typed in on the keyboard or 
sent by SuperKey. When the program is through reading or writing, it then 
reads the characters from the buffer — nothing is lost. 

Some programs, however, do not follow this procedure and may lose charac- 
ters sent to them while the disk is spinning. There are even programs that delib- 
erately throw these characters away by "flushing" the buffer. If you run into a 
problem like this, you should turn disk wait ON. This will prevent SuperKey 
from sending any characters while the disk is spinning. 



Examples 



Use the following keystrokes to turn disk wait ON: 

(AjTlQ (T|(wJ (T] 

or start SuperKey with this command: 

KEY /OW 
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You could also make a macro that turns disk Wait ON or OFF each time you 
press a key. Let's use I Ait f wl: press: 






See Also 



Keyboard buffer 
Save options 
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Display Macro 



Description 



A display macro is a macro that does not transmit characters to the apphcation 
program, but instead displays text in a window on the screen. With display 
macros you can easily create your own customized help texts. 

You must use a text editor to write your display macros. This can be any text 
editor producing standard ASCII text files, such as EDLIN, WordStar in non- 
document mode, SideKick's Notepad, or the Turbo Pascal editor. 

Many other editors can produce standard text files. If you are not sure what 
your editor does, ask DOS to TYPE one of your text files on the screen. If the 
text is displayed legibly, it's a standard text file. Even if your editor does not 
produce standard text files, it may have a way of doing so, perhaps by printing 
the text to a disk file. 

The file must contain the following information on the first line: 

<BEGDISP><F1D>1,1,3D,1D. 

The first symbol identifies the macro as a display macro, while the second 
symbol is the key this macro i \ fio I in this example) is assigned to. The numbers 
after the symbol specify the position and size of the window in which the macro 
is displayed. The first two figures are the column and line of the upper left corner 
of the window, the third figure is the number of columns (the width), and the last 
figure is the number of lines (the height). The numbers must end with a period. 

If you want to add a title or make the display macro auto-start, you must also 
do that on the first line. For example: 

<BEGDISP><FlD>l,l,3D,lD.<TITLE>Read Me<TITLE><flOTO> 

On following lines, write the text to be displayed. The maximum length of the 
lines is the specified window width (30 in the example). If you make your lines 
longer, they will be truncated. The window height you specify gives the number 
of lines in the window, but the macro can contain more lines. If it does, Super- 
Key automatically divides the text into pages, and you can page through it with 



WJ and (PgPpl . 
The display macro must end like any other macro, with the symbol: 

<ENDDEF> 
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Tages 

An automatic page break will occur for every Nth line in a window N lines high. 
This may produce undesirable results, so you can force page breaks anywhere 
you want by entering a Control-L (a form-feed character) into the file. The Con- 
trol-L can be entered either as a real control character, your text editor permit- 
ting, or as the symbol: 

<CtrlL> 

A display macro can be as long as your macro memory allows; the limit is 
approximately 65,000 characters. And each window can be as small as one char- 
acter by one line, or as large as 78 characters by 23 lines (the entire screen, when 
you add the frame), if macro memory permits. 

Video Attributes 

You can use three different video attributes in a display macro text: 

• Normal 

• Boldface 

• Frame 

Normal video is used if you don't specify anything else. 

Boldface text is indicated with Control-B's. The first Control-B in the text will 
toggle Boldface ON, the next Control-B will toggle it OFF again. 

Frame is the attribute used for the window frame but it can also be used in the 
text. A Control-D toggles the Frame attribute ON, another Control-D toggles it 
OFF again. 

These control characters can either be entered as real control characters or as 
symbols: 

<CtrlB> 
<CtrlD> 

How the three attributes appear on your screen depends on your screen type: 
monochrome, black and white, or color. If you are not satisfied with the attri- 
butes as they are, use the installation program to change them (see page 186). 
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Pop-up Windows 

Instead of entering specific values for the window position, you can enter a zero 
as either Line or Column value, or both. That will cause the window to open at 
the current cursor position. For example: 

<BEGDISP><F1>D,1,3D,1D. 

The top line of the window frame will be on line 1, and the left side of the 
window will be in the column where the cursor is presently located. If zero is 
specified for both Line and Column, the window will open with its top left cor- 
ner at the current cursor position. Making help text windows "follow the cursor 
around" like this is often very eflPective, since it catches the user's attention 
(which is usually focused on the cursor). 



Transparent Macros 

Transparent display macros are display macros that are cleared when a key is 
pressed. Just include the symbol <TRANSP> in the macro. See page 48 for 
details. 



Example 

Please see page 44 for an elaborate example. 

See Also 

Key symbols 
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Edit Macro 



Press 



Description 



The macro editor lets you create new macros and edit old ones. If you create a 
long and complicated macro containing many commands, you can fine-tune it 
later with the eDitor. 



To activate the editor from the main menu, press (Ait | T1 to get the main 
menu, then press [Mj for Macros and [^ for editor. You must then press the key 
whose macro you want to edit. If a macro is already assigned to that key, the 
editor screen will show you the macro; otherwise, the editor screen will be 
blank, except for the status line. 



Status Line 

Figure 7-8 shows the status line, which is the top line of the editor screen. 



Insert Fl -tielt ftltESC -txlt ftltC -Cow fllU HVive 



Figure 7-8 Editor Status Line 



Key 



Shows which key you are editing. 

Insert 

Indicates that you are in insert mode — that is, anything you type will be 
inserted at the cursor position. The (j^ key toggles between Insert and Over- 
write modes. In Overwrite mode, pressing a key will replace the character or 
symbol at the cursor position. 
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Help 
As anywhere else in SuperKey, you can press Ifi i to get help. 

aitEsc— Exit 

Press I Alt I Esc i to exit the editor. When you do that, you can either save the 
macro or quit without saving. 

AltC—Copy 

Copies the contents of another macro key into the macro you are editing, at 
the cursor position. The macro you copy from is unchanged. 

AltM— Move 

Moves the contents of another macro key into the macro you are editing, at the 
cursor position. The macro you moved is cleared. 

See Also 



Begin macro 

Interactive macro definition 
Macro memory 
Skip key 
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Encryption 

Press 



Description 



SuperKey's encryption scheme lets you encrypt (scramble) any file for total data 
and program security. You can choose between two diflPerent encryption 
methods: 

• The SuperKey in the file KEY.COM uses a proprietary algorithm for fast 
encryption. Files encrypted this way are safe against all but the most sophisti- 
cated intruders. If you want to use this method, type KEY l-^-*! when you load 
SuperKey. 

• The file KEYDES.COM contains a SuperKey that uses the DES encryption 
algorithm. This algorithm complies with the Data Encryption Standard issued 
by the National Bureau of Standards, U.S. Department of Commerce (FIPS 
publication 46, January 15, 1977). If you want to use this method, type 
KEYDES 1^-^ when you load SuperKey. 

Both algorithms use a unique keyword, supplied by you, as the basis of 
encryption and decryption. The same keyword must be used to decrypt an 
encrypted file, so don't call us if you forget your keyword; we can't help you. 



Be Careful 



Encryption can put you in a terrible mess if you're not careful. Please follow 
these guidelines: 

• Never encrypt a file that's already encrypted. 

• Only decrypt files that are encrypted. 

• Never change the name of an encrypted file. 

• Never mix the two encryption programs. 

The encryption algorithm in KEY.COM uses the file name as part of the 
encryption/decryption process, so if you change the file name, you'll not be able 
to get your file back. 



Reference to SuperKey 103 



The DES algorithm (in KEYDES.COM) uses different methods for encryp- 
tion and decryption. So if you encrypt a file twice, or decrypt a file that's not 
encrypted, the only way to get it back is to repeat the process in reverse order. 
This iDrocess does not use the file name. 

The two encryption algorithms are totally different, so be sure to use only one 
of them, or at least keep files separate if you want to use them both. 

An encrypted file contains absolutely no information about the encryption, 
and as we said before, Borland cannot help you restore scrambled files. We are 
not responsible for any damage that may be caused by careless encryption 
procedures! 

If several people work together, and have different keywords, it's a good idea 
to keep files separate, so that one group of users does not encrypt or decrypt 
somebody else's files with a wrong keyword. Use separate diskettes, or different 
subdirectories if vou have a fixed disk. 



Encrypting and Decrypting 

Use the Encrv'ption menu to choose between Encrypt file and Decrypt file. 

Use Encryption to scramble a normal file into unusable cipher, and Decryp- 
tion to turn this cipher back to normal. Never encrypt an already encrypted file 
or decrypt a file that isn't encrypted! 

Press CO to Encrypt a file, or [^ to Decrypt a file. A new window then opens 
where you; 

1. enter the name of the file(s) to be encrypted/decrypted 

2. enter and verify the keyword 

3. choose between non-text mode and text mode 



File Names 

The file name you specify for encryption can be any legal file name (see 
page 123). 

If you want to encrypt a series of files whose names match a certain pattern (all 
your data files, for example, may have the last name DTA), you can include 
special characters, so-called wildcards, in the file name. There are two such wild- 
cards — asterisk: » and question mark: ?. An asterisk stands for any series of char- 
acters, and a question mark stands for any single character. Let's look at some 
examples: 
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*. * Denotes files with any first name and any last name, i.e. all files. 

* .TXT Denotes all files with any first name and the last name TXT. 

??. ? Denotes all files with one- or two-character first names and one-char- 

acter last names. 

And so on, ad infinitum. You can use any pattern, mixing asterisks, question 
marks, and text. 

Verification 

If you specify a file name containing wildcards, you will be asked if you want 
verification before encrypting or decrypting. If you answer Yes (or just press 
I'^-'i ). the name of each file matching the file name pattern will be displayed 
before encryption, and you can accept or deny processing. If you answer No to 
"Verification?," all files matching the pattern will be processed without further 
warning. 

We advise extreme caution in the use of wildcards. Verification should be 
skipped only when you are absolutely certain that the pattern indicated by your 
wildcards doesn't include file names you didn't mean to encrypt/decrypt. Other- 
wise you might end up having files encrypted or decrypted "behind your back," 
so to speak. 

Protected Files 

A few files are protected against encryption. These are: 

C0MMAND.COM 
AUTOEXEC.BAT 
KEY.COM 
KEYDES.COM 

If you encrypted these files, you could lock up your computer, or be unable to 
decrypt your files again. 



Keyword 

After you have specified the file name, you must enter a keyword. This can be 
any word or sequence of words, up to 30 characters long. 
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The keyword you enter does not show on the screen — all you will see is a 
string of asterisks. This is to prevent someone from looking over your shoulder 
and reading your secret keyword. But since you can't see what you type, you 
must enter the keyword twice to make sure that you didn't make any spelling 
mistakes. 

Be sure to use the same keyword when you encrypt and decrypt. If you don't, 
you'll quickly end up in trouble. If that happens to you, the way to get out of it is 
first to reverse the process using the last keyword you used — that gets you back 
to where you were before you made the mistake — and then use the right key- 
word. 

Lower and uppercase characters in keywords are not distinct, so you won't get 
in trouble if you enter the encryption keyword in lowercase letters and the de- 
cryption keyword in uppercase. If you enter any spaces before or after the key- 
word, they will be deleted, but embedded spaces count as part of the keyword. 



Text Mode and Non-Text Mode 

Now that you have entered the file name and keyword, you are finally asked 
whether you want Text mode or not. Press (^ or l-^i if you don't want text mode; 
press [XJ if you do. Let's look at the two modes. 

Non-text Mode This is the method you will want to use to secure the files on 
your floppy or hard disk. The encrypted file is written directly on top of the 
original file. 

This means that no extra disk space is needed, and also that no part of the 
original file is left on the disk for anyone to look at. Each and every byte of the 
original file is physically encrypted. The encrypted file is binary, that is, it con- 
tains information in all eight bits of each byte. 

Files encrypted in non-text mode must be decrypted in non-text mode! 

Text Mode Text mode encryption is used to produce an encrypted file that 
can then be sent and received via modem communications programs that don't 
handle binary files. 

Text mode encryption leaves the input file untouched and produces a separate 
output file containing only uppercase letters from A through Z. The output file is 
much larger than the input file, so this method requires free space on your disk, 
approximately equal to twice the size of the input file. 
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Since the original file is left intact, this method does not secure your data on 
the disk against unauthorized access. It only produces an encrypted file suitable 
for transmission over a modem. 

Files encrypted in text mode must be decrypted in text mode! The recipient 
of a file that has been encrypted in text mode must select text mode when 
decrypting that file. 

Also, the file to be decrypted must have the saine name as when it was output 
by encryption. Text mode decryption produces a separate output file that is a 
duplicate of the file that was originally encrypted. 

Example 1 



Let's suppose you want to secure a database file called PERSONAL. DTA on 
your disk. Type: 

(Air|T]lT| 

CO 

Personal. dta l'<-'i 
MY OWN KEYWORD £] 
MY OWN KEYWORD EJ 

After you enter the keyword the first time, you are asked to enter it again. 
This is to protect you against mistakes. If the two entries do not match exactly, 
you must enter the keyword twice again. 

The last l-^l accepts the default answer (No) to the question "Text mode?". You 
don't want to transmit the encrypted file via a modem, so you will encrypt the 
file directly on top of itself 

Your file is now encrypted. You can still copy it, back it up, and restore it, but 
your database program cannot use it. 

It could have been any other type of file — a text file, a program — in fact, any 
file you want to secure. 

Now, to decrypt that file and get back the original contents, repeat the pro- 
cess. Type: 

OQCO 
CO 

Personal. dta l-^-'i 
my own keyword l-^i 
my own keyword l-^l 
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Note that upper and lowercase characters in the keyword are not distinct. You 
won't get into a mess if you enter your keyword in capitals when you encrypt, 
and use lowercase when you decrypt, or vice versa. 

Remember that the keyword must be exactly the same as you used for 
encryption, including embedded spaces. Any spaces before or after the keyword 
are deleted. 



Example 2 



Let's repeat example 1, only this time we will encrypt all files with the last name 
.DTA: 

CD 

(XI 

MY OWN KEYWORD El 

MY OWN KEYWORD £] 

The [2 accepts verification, so you will be asked to accept or deny processing 
for each file matching the pattern. Now decrypt them all again: 

(aoQCO 

».dta(^ 

dj 

MY OWN KEYWORD E} 
MY OWN KEYWORD SJ 



108 SuperKey Owner's Manual 



Example 3 



If your communications package won't let you transmit "object files" (files con- 
taining information in all eight bits of each byte, such as programs and files 
encrypted "on top" of themselves), you must use text mode to prepare a file for 
transmission over the phone. 

Type: 

fAjryri rri 
CO 

Myprog.coin l-^l 
transmission keyword l-^l 
transmission keyword l-*^! 

CD 

Transmit. fil(^ 

This time, you answer CLI to the question "Text mode?" because you want to 
produce an encrypted file that can be transmitted over a modem. 

You are now asked for the name of the output file. You can't use the same name 
as the input file, because SuperKey now produces a separate output file and 
keeps the input file intact. 

The output file contains only normal ASCII characters, and you can transmit it 
with any communications program. Note that the file contains a "header," which 
identifies it as an encrypted file, and a "terminator," to mark the end. 

The receiving party must reverse the process, again using text mode: 

(Airxr|(T| 
CD 

Transmit. filEJ 
transmission keyword l-^-*! 
transmission keyword l-^l 

m 

Newprog.com l-^i 

The file now to be decrypted must have the same name as when it was output 
by encryption, but the output file name may be different from the original name. 

If you download the file from a bulletin board, it may change names along the 
way. Be sure it has the right name before decrypting. 

Because of the header on the encrypted file, SuperKey recognizes it as a text 
file. The output file will be an exact duplicate of the file you originally encrypted 
(and much smaller than the encrypted text file). 
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Some communications packages don't allow you to receive files, but can only 
"dump" your entire communication to disk, including log-on procedures and 
miscellaneous chit-chat. In that case you will have some irrelevant text in your 
file before the encrypted text starts, and probably some after it ends. 

The receiving party must remove any irrelevant text at the start of the file 
before decrypting the file. The encryption header must be placed at the very 
start of the file. Use your text editor to delete the first part of the file, up to, but 
not including, the encryption header which appears as follows: 

•♦»SDPERKEY TEXT-ENCRYPTION START*** 

SuperKey automatically removes any irrelevant text at the end of the file 
because it stops encryption when it meets the encryption terminator, which 
looks like this: 

»»»SOPERKEY TEXT-ENCRYPTION END*** 



See Also 



Encryption directory 
File names 
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Encryption Directory 



Press 

(AiTxri d] CO 



Description 



Encryption directory lets you specify a location where SuperKey will look for 
files to encrypt. This location may be a full DOS path name (see page 193 for an 
explanation of directories and paths), or it may just be a drive name like A: or B:. 
If you just enter a drive name, the files will be found on the currently active 
directory of that drive. 

The drive or path you specify becomes active immediately when you press 
l-^l . If you want SuperKey to find its files on the logged drive/current directory, 
then don't enter anything, just press l-^l . 

The default directory you specify will be used only with file names without a 
path name. You can override the default by entering a full file path when you 
start Encrypt. 

The directory you specify is stored only in your computer's internal memory. 
If you want SuperKey to use the new setup the next time you load it, you must 
record it permanently by selecting Save setup. 



Example 



Suppose all your program files are in a directory called \ SYSTEM. You could 
encrypt all .COM files here, rendering your computer useless to people without 
the password. Specify the path to SuperKey as follows: 

rAinmrsim \systemE] 
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Now, each day before you shut down your computer, you can encrypt all your 
programs by entering: 

(XI 

».comE] 

my keyword ej 
my keyword ej 

di 

Because of the path specified in the Encryption directory, this will encrypt all 
.COM files in the \ SYSTEM directory, but leave all other directories untouched. 

C0MMAND.COM (essential for starting the computer), KEY.COM, and 
KEYDES.COM are protected from encryption. Even if they are in the 
\SYSTEM directory, you'll still be able to start your computer and decrypt your 
files the next morning: 

CO 

».COM (^ 

dj 

MY KEYWORD £1 
MY KEYWORD EJ 

See Also 



Save setup 
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End Macro 



Press 



I Alt IF I (may be redefined, see page 90) 

or fAJTIT) |¥1 m 



Description 



The End macro command terminates the interactive recording of a macro. When 
you press [Alt | F1. characters are no longer sent to macro memory, and the macro 
is ready to be used. 

This command is also used to end the definition of a Title; see page 175. 



See Also 



Begin macro 
Titles 
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Entry Mask 



Description 



SuperKey lets you specify the type of data you can enter into variable and fixed 
fields, by writing special characters — an entry mask — between the field delim- 
iters I Ctrl I PI or rctrim . The entry mask can specify the following types: 

• Numeric only 

• Uppercase alphabetic only (converts lowercase to upper) 

• Lowercase alphabetic only (converts uppercase to lower) 

• Upper or lowercase alphabetic 

• Any character 

Note that the Format fields option must be ON to record entry masks inter- 
actively. 

Numeric Only 

An N in a field means that only numeric data may be entered — digits, decimal 
points, plus and minus. Any other character will be ignored. 

Uppercase Alphabetic Only 

A U in a field means that only the uppercase characters A through Z may be 
entered. If the lowercase equivalents are entered, they will be converted to 
uppercase. Any other character will be ignored. 

Lowercase Alphabetic Only 

An L in a field means that only the lowercase characters a through z may be 
entered. If the uppercase equivalents are entered, they will be converted to 
lowercase. Any other character will be ignored. 
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Alphabetic Only 

An A in a field means that only alphabetical characters A through Z and a 
through z may be entered. Any other character will be ignored. 



Any Character 

Any other character in a field (for example, a space) allows you to enter any 
character. Note, however, that the characters C, R, periods, and commas control 
the field format (see page 119). 

The way entry control masks work diflPers between variable and fixed fields, as 
described next. 

Variable Fields An entry control mask in a variable field determines the 
type of entry allowed character-by-character. However, since the length of the 
field is variable, the last entry control character entered determines the legal 
input types in the rest of the field. 



Examples 



— you can enter only numeric information into this field. 
OQ fidtrlQ 

— you can enter only alphabetical characters into this field. 
fCtrrj^ UL(CtrrjQ 

— the first character entered into this field will be converted to uppercase, and 
all following characters will be converted to lowercase. 

fctfilFl DOLLN fctPilFl 

— the first two characters in this field will be converted to uppercase, the next 

two will be converted to lowercase, and the rest of the field accepts only 

numbers. 
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Fixed Fields The entry control mask in a fixed field controls the contents of 
the field character-by-character. DiflPerent control characters within one field let 
you enter one type of data in some positions in the field, and other types of data 
in other positions. 

Examples 

[Ctrl|T| NlarTjITJ 

— a one-character fixed field into which you can enter only numeric information. 

drlJTJ A[Ctr[KT| 

— a one-character fixed field into which you can enter only an alphabetical 
character. 

[CtrTllXI AN[CtrryT) 

— a two-character fixed field into which you can enter only an alphabetic char- 
acter in the first position and numeric information in the second position. 

(cjiiXri utm NNN rct?nrn 

— a seven-character fixed field that accepts uppercase characters in the first 
three positions, any character in the fourth position, and numeric information 
in the last three positions. 

See Also 



Field formats 
Fixed field 
Format fields option 
Variable field 



116 SuperKey Owner's Manual 



Fields 



Press 



(liLlQ or OQ (¥] (TJ to start and end a variable field 

rctrm or CaOLI d] (XJ to start and end a fixed field 
(may be redefined, see page 90) 

Description 



A field included in a macro temporarily stops playback and lets you enter a value. 
When you're finished, macro playback resumes. Format and entry control masks 
can be used to control what can be typed into a field, and how it is displayed on 
the screen. 

Fields come in two flavors: variable and fixed. A variable field can contain as 
few or as many characters as you enter into it, while a fixed field always contains 
a certain number of characters, as specified in the definition of the field. 

Variable fields, fixed fields, field format masks, and entry control masks are 
described separately in this section. A detailed step-by-step example can be 
found in Chapter 5. 

As long as a field is not yet terminated, you can press the backspace key, l-^~l . 
to delete your characters from right to left. 

A variable field must always be terminated by pressing l-^l . A fixed field is 
automatically terminated when you enter the last character of the field, but it 
can be terminated earlier by pressing l-»-^l . 

Fields are limited to a maximum of 255 characters. 



Examples 



— declares a variable field 

(^rTjTj (^^ (^^ (^^ i:;;^ 1^^ i:;^ (3?^ 

— declares a fixed field 6 characters long 
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See Also 



Entry control 
Field formats 
Fixed field 
Variable field 
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Field Formats 



Description 



SuperKey lets you format the data you enter into variable and fixed fields by 
writing special characters — a format mask — between the field delimiters I ctn I FH 
or I Ctrl m . The following formats are available: 

• Left adjusted (default) 

• Right adjusted 

• Centered 

• Numeric formats 

The first three apply to fixed fields only. Because variable fields are only as 
long as the entry, there is nothing to adjust. 

Note that the Format fields option must be ON to i-ecord field formats inter- 
actively. 



Left Adjusted 

By default, the contents of a fixed field are written left-adjusted within the 
field — that is, the first character starts at position one. If the field is terminated 
before it is full, the rest of the field will be padded with fill characters. The fill 
character is a space by default, but any other character can be chosen with the 
fill cHaracter command on the Defaults menu. 



Right Adjusted 

Right-adjust the contents of a fixed field by placing an R right after the first field 
delimiter. The R does not count in the length of the field. When you type charac- 
ters into a field, the first character will still start at position one, but as soon as 
you press l-^l to terminate the entry, it will be rewritten with its last character 
in the rightmost position of the field. The rest of the field to the left of your entry 
will be padded with fill characters (spaces by default). 
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Centered 

Center the contents of a fixed field by placing a C right after the first field delim- 
iter. The C does not count in the length of the field. When you type characters 
into a field, the first character will still start at position one, but as soon as you 
press l-^-^i to terminate the entry, it will be rewritten with an equal number of fill 
characters on either side to fill out the format (in case of an odd number of fill 
characters, the left side will be the larger). 



Numeric Formats 

The format for numbers is specified by one or more # signs, and optionally a 
period to specify a decimal point and/or one or more commas to define the posi- 
tion of delimiters. 

The eflPect of delimiters in a numeric format differs among variable and fixed 
fields. 

Variable Fields In a variable field, a comma must be entered as the first 
character in the field definition. It will cause a comma to be printed for every 
third digit of the integer part of a number. In the following field 

the number 1234.5 would be printed as 1,23^.50. 

Fixed Fields In a fixed field, comma delimiters must appear in the format 
mask for every position where you want the delimiter. You can "force" a format in 
your numeric data with comma delimiters. In the following field 

the number 1234.5 would be printed as 15,3^.50. 
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Examples 

— a variable field that will display any number with two decimals: 
1E3 will be displayed as 1E3 . QD 
1 2 3. 45 1 will be displayed as 1B3.45 
.153 will be displayed as 0.12 

fctFTIFl ,.## fcuTIFI 

— a variable field that will display any number with two decimals and a comma 

for every third digit to the left of the decimal point: 

123 will be displayed as 123.00 

12345t will be displayed as 123 , 45t . QD 

.123 will be displayed as 0.12 

— a four-character fixed field that will display a two-digit number with one deci- 
mal (\ symbolizes a fill character): 

12 will be displayed as 12.0 

. 1 will be displayed as \ . 1 

fctFrjiTi ##,##,## rctrirn 

— an eight-character fixed field that will display a six-digit number with a comma 
for every second digit (\ symbolizes a fill character): 

123 will be displayed as \\\\1,23 

12345ti will be displayed as 12,3'^,5t 

. 1 will be displayed as eight blanks, since there are no decimals in this format; 
the decimal point and anything following it are ignored. 

(WKxi cwwwwwwwwww (wni 

— a twenty-character fixed field that will display any entry centered within the 
field length (\ symbolizes a fill character): 

CENTERED will be displayed as WWWCENTEREDWWW 
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See Also 



Defaults 
Entry control 
Fill character 
Fixed field 
Format fields option 
Variable field 
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Fife Names 



Description 

A file name consists of a first name of 1 to 8 characters, optionally followed by a 
period and a last name of 1 to 3 characters. 

A file name may also specify a path. A path is used to identify subdirectories in 
a DOS tree-structured directory. For example: 

\KEY\MflC\WS.MfiC 

specifies the file WS.MAC in the directory MAC which is a subdirectory to 
KEY, which is a subdirectory to the root directory. 

File names specified for encryption may also include wildcards to make the 
name match a series of files. There are two such wildcards: asterisk (*) and ques- 
tion mark (?). An asterisk stands for any series of characters, and a question mark 
stands for any single character. Let's look at some examples: 

*. * Denotes files with any first name and any last name, i.e., all files. 

*.MAC Denotes all files with any first name and the last name MAC. 

???. ?? Denotes all files with first names of one to three characters and one- or 
two-character last names. 

You can mix asterisks, question marks, and letters to produce any file-name 
pattern. 

Examples 



LETTER 
LETTER.TXT 
\LETTEES\LETTER.TXT 
\DATA\DBaSE\».DTfi 



See Also 



DOS primer (Appendix E) 
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Fill Character Default 



Press 

I Alt jf Tj (T| [¥) (or use /DH parameter on DOS command line) 



Default value 



Space 
Description 



Super Key uses fill characters to pad fixed format fields if they are not completely 
filled in. 

The fill character is a blank space by default, but you can select any other 
displayable character. Press I Ait f Tj to activate the Command menu, then select 
Defaults, and finally select fill cHaracter. The current value of the fill character 
is displayed to the right of the text, and you can now enter any other character 
you want to use. 



Example 



If you want to use a hyphen as fill character, press 

(AirjIJ [0 (Tj □ 

or start SuperKey with this command: 

KEY /DH- 

See also 



Defaults 
Fixed fields 
Save defaults 
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Fixed Field 



Press 



I C'ri m (may be redefined, see page 90) 

or fAinrri rFim 



Description 



A fixed field included in a macro defines a space of a given size into which you 
can enter text or numbers during macro playback. When you're finished, macro 
playback resumes. 

The definition of a fixed field specifies the length of the field, and special 
characters (format and entry control masks) can be used to control what can be 
typed into a field, and how it is displayed on the screen. 

As long as your entry is not terminated, you can press l-^-~l (the backspace key) 
to delete characters from right to left. 

A fixed field is automatically terminated when you enter the last character of 
the field, but it can be terminated earlier by pressing l-^l . 

The maximum length of a fixed field is 255 characters. 



Example 



(ariiT] c:::j (^ c^ c^ c^ c::::::! caxi 

rAinr^ 



Defines a fixed field six characters long. 
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See Also 



Entry control 
Field formats 
Variable field 
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Format Fields Option 



Press 

I Alt r n (TJ (TJ (or use /OF parameter on DOS command line) 

Default value 



OFF 
Description 



By default, anything you enter between the start and end of fixed and variable 
fields is not recorded in the macro when you record interactively. This allows you 
to use the macro over and over again, entering difierent characters each time. 

If you want to make entry control masks or formatted fields, however, the 
characters you enter must he recorded. This is accomplished by switching this 
option ON. 



Example 



To switch it ON, press 

(atiLI CD (XJ ej 

or start SuperKey with this command: 

KEY /OF 

You can let a macro toggle the status of the Format field option each time you 
press a key. Let's use I Alt i fFl: press 



lAy^ lAKjLLl 

[AirxoiDlTi 



lAy^ 
See also 



Entry control 
Field formats 
Options 
Save options 
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Functions Menu 



Press 



Description 



Functions are small "programs" you can include in macros to make them perform 
various tasks during playback, such as making sounds, switching the screen oflP 
and on, displaying current time or date, and so on. 

The Functions menu can only be activated while you are defining a macro, 
because functions are only used during macro playback. 

To include a function in a macro, select it from the Functions pull-down menu 
while you are defining the macro, either interactively or in the macro editor. 

Press fAiniTJ to get the main menu, then (TJ- To enter a function into the 
macro you are defining, move the highlighted bar to the function and press I^J, 
or just press the capital letter in the name. The Beep and Delay functions 
require a little additional input, so a small window will open, prompting you to 
enter the necessary values. 



m: <n> Tsxt- rren <*lt-> to emj. 



Nacms CaamMmim 



•efaalts Encryption Lat|iMit Setup 



Clear tcreea 

•elaij factor 

Ie<|koar4 lock 

LofseJ 4riv0 

FaU 

loal tiao Jalay 

Screea off 



Tiao 

cUt aai raite 



Figure 7-9 Functions Menu 
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You'll find each function described separately in this section. Table 7-3 lists all 
functions and the keystrokes used to access them. 

Table 7-3 List of Functions 



Function 


Press 


dAte 


(Air|Xi(T](T] 


dAte 


(Airj[0(T|(TJ 


Beep 


(AJTXTJCQd] 


Clear screen 


lAIJI/JiFjiCj 


Delay 


(AirxDtXItU 


Keyboard lock 


[AjLlLICDd] 


Logged drive 


(Airxr||T|(Tj 


Path 


(AirXOlTJITJ 


Screen off 


(AirXOITJtTI 


screen On 


(AJTIQ (T| (T| 


Time 


(AirjDIXKU 


cUt and paste 


fAiryri ro ru] 



Examples 



This macro will start a program called TONES, and sound a beep when the 
program finishes: 

(aOQ rSTjfFiol TONES EJ- 

[AltJLl CO [U 50D ej 5DD ej 3DD ei(ArjQ 

This beep will be 500 Hertz and last for three seconds, enough to wake any- 
one. You could add a more musical note by making three beeps with different 
frequencies, with a short delay between them: 

(AJTJQ r^TFiol TONES 1^^ 

(Aitjri (TJ (T| 4DD (^ <DD (^ iQD (^ 

0[D CO (D 5QD ej 5DD (^ 150 O 

CAir|[Q(T|(T|5DDeJ 

OQ d] CO tDD E) tDD S) SDQ eJ 

fAinF 
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Interactive Macro Definition 



Description 



You define a macro interactively when you define it while you actually work with 
your application program. Anything you put into the macro is also sent to the 
application, so you can immediately see the eflFect. This makes it easy to define 
complicated command sequences. 

Interactive macro definition is started with the Begin macro command; see 
page 71. 

If you don't want characters sent to your application program, the macro 
editor can be used to create and edit macros. See page 101. 



See Also 



Begin macro 
Edit macro 
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Keyboard Buffer 



Description 



The IBM PC BIOS gives you a 16-character keyboard "type-ahead" buffer that 
allows you to enter up to 16 characters on the keyboard even when the computer 
is busy doing something else, like reading or writing on the disk; the characters 
will be saved and read by your computer when it is finished with its task. Often 
you'll find that 16 characters is not enough; the computer starts beeping at you. 

With SuperKey loaded (even if it is not active), you have a 128-character type- 
ahead buffer instead. You should never run into another beep. 
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Keyboard Click On/Off Option 



Press 

I Alt f Tl [¥] (^ (or use /OK parameter on DOS command line) 



Default value 



OFF 



Description 



When Keyboard click is ON, you'll hear a click each time you press a key. If you 
use the standard IBM keyboard, you probably have all the clicking you want in 
hardware — so SuperKey's click is OFF by default. But if you have another key- 
board, you may choose to emulate the IBM sound by setting this option ON. 



Examples 



Turn keyboard click ON with the following keystrokes: 

or start SuperKey with this command: 

KEY /0K+ 

You can design a macro that will toggle keyboard click on and oJ0F each time you 
press a key. Let's use I Ait 110 : press 

(Mj^(Air|j^(7ir)(T](^ 



See also 



Options 
Save options 
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Keyboard Lock/Unlock Function 



Press 

I Alt |f/~| (^ (TJ (or use /FK parameter on DOS command line) 



Description 



Keyboard lock/unlock is a function that can be included in a macro. When the 
macro is played back, you will be asked to enter a keyword. The keyboard is then 
locked until you enter the keyword again. 

To enter a keyboard lock/unlock into a macro, first define the key, then select 
Functions, then Keyboard lock. 



Example 



The following keystrokes will make I Ait fr\ lock the keyboard: 

(AirjTJ (TJ (T| 

If you look at this macro in the macro editor, it appears as follows: 

<CMD>FK<CMD> 

with the (Alt j fTl command symbolized by <CHD>. 

You can also lock your keyboard when you load SuperKey on the DOS command 
line by typing 

Key /FKpas sword 

where password represents a password up to eight characters long. 



See Also 



Functions 
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Key Symbols 



Description 

You only need concern yourself with key symbols if you want to use the macro 
editor. When you look at a macro definition in the editor, you will notice that 
keys and key combinations are symbolized by a short descriptive text enclosed in 
angle brackets. For example: 

<F1> ■ = the fFil key 

<AltD> = the rAiTTDl key combination 

A key combination is achieved by holding down the first key while pressing the 
other. To get an <AltD>, for example, you hold down the I Ait I key and then press 
the (T) key. 

The special SuperKey commands, such as Begin macro, End macro, and Vari- 
able field, have special, unchanging descriptive symbols: 

<BEGDEF> = the Begin macro command C lAit jf^ by default) 
<EKDDEF> = the End macro command ((AJTJQ by default) 
<VFLD> = the Variable field command ([ctriJQ by default) 

(Remaining command symbols can be found on page 137.) 

The reason for these special symbols is that the SuperKey commands can be 
redefined (by changing the Defaults, see page 90). If, for example, the Variable 
field command I Ctrl iT -X were symbolized as <Ctrl-> in the macro definition, it 
would no longer be recognized as a command should you later change the Vari- 
able field command to something else — ^for example I Ait |(T| . With unchanging 
symbols, the command will always be recognized, no matter what keystrokes are 
used. 

Key Symbols 



Table 7-4 lists all keys and key combination symbols. Symbols are enclosed in 
angle brackets and the default command keys are marked with a •. 
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Table 7-4 List of Keys and Key Symbols 



Key 


Alone 


Within 


With L£1U 


WithlAiy 


[U 


a 


A 


(CtrlA) 


(AltA) 


{B 


b 


B 


(CtrlB) 


(AltB) 


dJ 


c 


C 


(CtrlC) 


(AltC) 


(D 


d 


D 


(CtrlD) 


(AltD) 


CD 


e 


E 


(CtrlE) 


(AltE) 


CO 


f 


F 


(CtrlF) 


(AltF) 


CO 


g 


G 


(CtrlG) 


(AltC) 


ca 


h 


H 


(CtrlH) 


(AltH) 


□ 


i 


I 


(Ctrll) 


(Altl) 


{J} 


j 


J 


(CtrlJ) 


(AltJ) 


CO 


k 


K 


(CtrlK) 


(AltK) 


CO 


1 


L 


(CtrlL) 


(AltL) 


Cm) 


m 


M 


(CtrlM) 


(AltM) 


(T| 


n 


N 


(CtrlN) 


(AltN) 


CO 








(CtrlO) 


(AltO) 


CO 


P 


P 


(CtrlP) 


(Alt?) 


CO 


q 


Q 


(CtrlQ) 


(AltQ) 


CO 


r 


R 


(CtrlR) 


(AltR) 


CO 


s 


S 


(CtrlS) 


(AltS) 


m 


t 


T 


(CtrlT) 


(AltT) 


CO 


u 


U 


(CtrlU) 


(AltU) 


[v] 


V 


V 


(CtrlV) 


(AltV) 


(1) 


w 


w 


(CtrlW) 


(AltW) 


d] 


X 


X 


(CtrlX) 


(AltX) 


G] 


y 


Y 


(CtrlY) 


(AltY) 


[0 


z 


Z 


(CtrlZ) 


(AltZ) 


CO 


[ 


{ 


(Esc) 


(Alt[) 


□ 


\ 


1 


(Ctrl\) 


(Alt\). 


m 


] 


} 


(Ctrl]). 


(Alt]). 


1- J 


Space 


Space 


Space 


Space 


^ 


<F1) 


(ShftFl) 


(CtrlFl) 


(AhFl) 


tF2j 


(F2) 


(ShftF2) 


(CtrlF2) 


(AltF2) 


LF3J 


(F3) 


(ShftFS) 


(CtrlF3) 


(AltF3) 


(RJ 


(F4> 


<ShftF4) 


(CtrlF4) 


(AltF4) 


IFSJ 


<F5) 


(ShftFS) 


(CtrlFS) 


(AltF5) 


irej 


(F6) 


(ShftF6) 


(CtrlF6) 


(AltF6) 


LF7J 


(F7) 


(ShftF7) 


(CtrlF7) 


(AltF7) 


LF8J 


(F8) 


(ShftFS) 


(CtrlFS) 


(AltFS) 


dO 


<F9> 


(ShftFQ) 


(CtrlF9) 


(AltFQ) 


(ROJ 


(FIO) 


(ShftFlO) 


(CtrlFlO) 


(AltFlO) 
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Table 7-4 List of Keys and Key Symbols, continued 



Key 


Alone 


Withl^ 


WithfCtrfJ 


WithlAltJ 


Upper row: 








□ 


1 


! 


(Ctrll) 


(Altl) 


m 


2 


@ 


(Ctrl2) 


(Alt2) 


dj 


3 


# 


(Ctrl3) 


(Alt3) 


a 


4 


$ 


(Ctrl4) 


(Alt4) 


m 


5 


% 


(Ctrl5) 


(Alts) 


dj 


6 


A 


(Ctrl6) 


(Alt6) 


(H 


7 


& 


(Ctrl?) 


(Alt?) 


dj 


8 


* 


(Ctrl8) 


(Alts) 


(D 


9 


( 


(CtrlQ) 


(Alt9) 


CO 





) 


(CtrlO) 


(Alto) 


□ 


- 


_ 


(Ctrl-). 


(Alt-). 


Q 


= 


+ 


(Ctrl=) 


(Alt=). 


Numeric 


keypad (with (^ OFF): 






Q 


(End) 


(1) 


(CtrlEnd) 


(AltEnd) 


di 


(Dn) 


(2) 


(CtrlDn) 


(AltDn) 


d) 


(PgUp) 


(3) 


(CtrlPgDn) 


(AltPgDn) 


a 


(Lft) 


(4) 


(CtrlLft) 


(AltLft) 


dJ 


(Ctrl) 


(5) 


(CtrlCtr) 


(AltCtr) 


d] 


(Rgt) 


(6) 


(CtrlRgt) 


(AltRgt) 


di 


(Home) 


<7) 


(CtrlHome) 


(AltHome) 


dj 


(Up) 


(8) 


(CtrlUp) 


(AltUp) 


dl 


(PgUp) 


(9> 


(CtrlPgUp) 


(AltPgUp) 


dl 


(Ins) 


(0) 


(Ctrllns) 


(Altlns) 


□ 


(Del) 


(.) 


(CtrlDel) 


(AltDel) 


□ 


(Min) 


(Min) 


(CtrlMin) 


(AltMin) 


di 


(Pis) 


(Pis) 


(CtrlPls) 


(AltPls) 


dj 


(*> 




(CtrlPrt) 


(AltPrt) 


□ 


' 


- 


(Ctrl') 


(Alt') 


□ 


• 


~ 


(Ctrl') 


(Alt') 


□ 


, 


( 


(Ctrl,) 


(Alt,) 


□ 




) 


(Ctrl.) 


(Alt.) 


□ 


/ 


P 


(Ctrl/).* 


(Alt/). 


□ 


' 




(Ctrl; ) 


(Alt; ) 


liscj 


(Esc) 


(Esc) 


(CtrlEsc). 


(AltEsc) 


IWJ 


(Tab) 


(ShftTab) 


(CtrlTab) 


(AltTab) 


ll=J 


(Bks) 


(Bks) 


(CtrlBks) 


(AltBks) 


^ 


(Enter) 


(Enter) 


(CtrlEnter) 


(AltEnter) 



* Only on the IBM PCjr after running the PCJRINST program. 
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Command Symbols 



When a SuperKey command appears in a macro, it is represented by the special 
symbols shown in Table 7-5. These symbols allow redefinition of command key- 
strokes, while retaining compatibility with old macros. When key symbols are 
used as parameters on the DOS command line (see page 77), square brackets [ 
and ] must be used instead of the angle brackets. This is because DOS under- 
stands the angle brackets as "pipe" commands. 



Table 7-5 List of Command Symbols 



Command 


Symbol 


Default Key 


Menu 


(CMD) 


(Airjrj 


Begin/end title 


(TITLE) 


^TQ 


Begin macro 


(BEGDEF) 


Sa 


Fixed field 


(FFLD) 


[ctri|T| 


Var field 


(VFLD) 


[CtrlJQ 


Auto-start 


(AUTO) 




End macro 


(ENDDEF) 


(AOQ 


cUt and paste 


(CUT) 


(AJFjCO 


Command stack 


(STACK) 


{WJ^ 


sKip macro 


(SKIP) 


□ 


stoP 


(STOP) 
(SHOW) 


1 Ctrl 1 Esc 1 


shoW titles 


1 AltJ PrtScJ 


Sidekick 


(SIDEKICK) 





See Also 



Defaults 
Edit macro 
Keys 
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Kill SuperKey 



Press 

I Alt fT) fctrTI Home j I End | (or use /K parameter on DOS command line) 



Description 



At some point you may need to "kill" SuperKey — remove it from memory to free 
up space for other programs. This may be desirable if you need to create more 
room for other programs without resetting the computer. 

But it should be done with caution, and only after observing the following 
rules: 

It must only be done if there are no other programs in memory after Super- 
Key. This means that you must not kill SuperKey if you have an application 
program running. That is, be sure you are on the DOS command line before you 
kill SuperKey. But first be certain there are no other resident programs loaded 
after SuperKey. This means that if you have Turbo Lightning and/or Side Kick in 
memory, you must kill them first. Kill the programs in the reverse order they 
were loaded in — i.e., SideKick, Turbo Lightning, then SuperKey. If you kill 
SuperKey while other programs occupy inemory "above" it, you will create an 
unoccupied "hole" in memory — a situation that DOS cannot handle. You will 
have to reset the computer, and perhaps even turn it off and back on again. 

To kill SuperKey, call the main menu to the screen by pressing I Ait jjT) . Then, 
hold down the I ctn I key and press the I Home j and I End! keys. 
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Load Layout 



Press 



Ainrn (TJ ITJ (or use FILENAME /LL parameter on DOS command line) 



Description 



The Load layout command reads a keyboard layout from a disk file created with 
the layout editor (described in Chapter 6). The layout becomes effective immedi- 
ately. 

To load a layout, press I Ait j Tl to get the main menu, then press (XI twice. The 
window shown in Figure 7-10 opens, requesting you to enter the name of the file 
you want to load: The name you enter here can be any legal file name, optionally 
including a DOS path name (see page 123 for a discussion of file and path 
names). If you do not specify a last name, the last name .LAY is assumed. 



flacros CowMals Funct io 



krultx I>cr<|ptii» 



E ENTER FILE NM1E ■ 
ORAI I 



Figure 7-10 Load Layout Window 



Example 



To load the Dvorak layout from the file DVORAK. LAY, type 

fAinrn (TJ (TJ dVORRK (^ or start SuperKey with this command: 

KEY DVORAK /LL 
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Load Macro 



Press 



ATfn (¥] (T| (or use FILENfiME /ML parameter on DOS command line) 



Description 



The Load macro command loads a macro that was stored in a disk file into macro 
memory. Any macros you've been using so far will be deleted. (If you don't want 
to delete them, see Merge Macro on page 148.) 

To load a macro file, press I Ait f Tj to get the main menu, then press (^ and 
(TJ- A window opens, requesting you to enter the name of the file you want to 
load: The name you enter here can be any legal file name, optionally including a 
DOS path name (see page 123 for a discussion of file and path names). If you do 
not specify a last name, the last name .MAC is automatically assumed. 



C o— iWi Functlo 



lefailts Iicrvrtloi Uyoit Setif 



Title 

rixed FieU 
UiF FieU 
<utO-start 
End 

cOt iU rut( 

e»it 

[ISQHi — ErrrEX file NMit 

123 



nerje I 121 
Clur I 



=1 



Figure 7-11 Load Macro Window 

On your distribution disk are a number of files containing macros; these files 
have the last name .MAC. You can load any of these files, or ones you make 
yourself 

See page 189 for more information about the .MAC files. 
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Example 

To load the WS.MAC file on your distribution disk, press 

|Air|T| [Mj (T| 

When this macro is first loaded, you will see a brief message describing the 
macros contained in WS.MAC (special macros to be used with WordStar). 

To automatically load a macro when you start SuperKey from a .BAT file, 
include a command like this in the file: 

KEY MYMftCRO /ML 

That will cause the macro file MYMACRO.MAC to be loaded. 

See Also 



Auto-start macro 
Merge macro 
Save macro 
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Logged Drive Function 



Press 

(AjTKLKXIfXJ 

Description 



Logged drive is a function that can be included in a macro. When the macro is 
played back, the letter of the currently logged drive is displayed. 

To enter a Logged drive function into a macro, first activate the main menu, 
then select Functions, then Logged drive: 

OQCDCU 



See Also 



Functions 
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Macro 



Description 

A macro is any number of characters that you store in a key. This key no longer 
contains its original one character, but all the characters in the macro. 

When the key is pressed, all the characters in the macro are played back, 
exactly as if all the keys stored in the macro were pressed again. 

SuperKey lets you assign macros to almost any key on the keyboard, and to 
combinations of these keys with the following "shift-state" keys: 

o 

fctFil 

l-Q- i (left and right hand shift keys) 

A key combination is achieved by holding down one of these shift-state keys 
while pressing another key. To get a I ctn I fDl. for example, you must hold down 
the I Ctrl I key and then press the (XI key. 

The keys to which you cannot assign macros are the shift-state keys alone: 

[AJT] 



Scroi I 



Lo5 



[PrtScl 



and any of SuperKey's command keys. These are listed on page 137, and can also 
be found on the Defaults menu (press I Ait j Tl (T) to see them). 

Although you can assign macros to any other key, it could cause confusion if 
you inadvertently assign macros to letters or numbers. If you assign a macro to 
an alphabetic key ([a^ through (^ with or without l-Q-i ) or to a numeric key, you 
will therefore get a warning. 



See Also 



Key symbols 
Skip key 
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Macro Directory 



Press 
Description 



Use Macro directory to specify where SuperKey will look for its macro (.MAC) 
and layout (.LAY) files. This location can be a full DOS path name (see page 123 
for an explanation of directories and paths), or it may just be a drive name such as 
A: or B:. If you just enter a drive name, the files will be found on the currently 
active directory of that drive. 

The drive or path you specify becomes active immediately when you press 
l-^-'l . If you want SuperKey to find its files on the logged drive/current directory, 
don't enter anything — just press l-^l . 

The directory you specify is stored only in your computer's internal memory. 
If you want SuperKey to use the new setup next time you load it, you must 
record it permanently by selecting Save setup on the Setup menu. 

The directory you specify is used only when you type a file name with no path 
name. You can override the default directory by entering a full file path when 
specifying macro and layout file names. 



Examples 



Suppose you want to collect all your macro and layout files in a directory called 
\MRC. Simply enter: 

fAir|rr| rsinvn\HAcR^ 

SuperKey will now look for .MAC and .LAY files on the \MfiC directory unless 
you override it as described above. If you are working with floppy disks, you are 
likely to want SuperKey to find its files on the A: drive, so you'll enter 

(AiTXrididJA: ej 



See Also 



Save setup 
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Macro Memory 



Description 



Your computer contains electronic circuitry where programs and data can be 
stored and retrieved. This circuitry is your computer's memory, also called RAM 
(Random Access Memory), because information can be read and written any- 
where in a large array of memory "cells." 

The amount of memory varies among computers. The usual minimum is 64 
Kbytes (one Kbyte = 1024 bytes) one byte being equal to one memory "cell." 
Many 16-bit computers have much more memory, however, and many can be 
expanded beyond their standard configuration by adding extra chips or extra 
boards to the computer. 

SuperKey uses only part of your computer's memory. The resident part of 
SuperKey (the part of the program that remains in memory at all times) uses 
some memory, and more memory is set aside to hold macros. We call this part of 
memory the macro memory. 

The amount of memory required for the resident part of SuperKey cannot be 
varied, but you can control the amount of memory reserved for macros. The 
default macro memory size is 8000 bytes, but you can use the KEYINST installa- 
tion program to choose a smaller area if you have memory problems, or a larger 
area if you plan on defining many or very long macros (see page 183 for details on 
using KEYINST). 

When you load SuperKey, some information about the memory in your com- 
puter is printed on the screen, as shown in Figure 7-12. 



6SS3bB tytes total mcman) 
5979S8 kytes were frea 
533424 I'iiea tree 

9588 b<jtes aacro aaiory 



CABORLANgsny >_ 



Figure 7-12 SuperKey Meinory Information 

It first tells you how much memory you have in total, then the memory avail- 
able after the operating system (DOS), and other resident programs (bufiers, 
drivers, spoolers, RAM disks, or what have you). The third line shows the 
amount of memory left after SuperKey was loaded. This figure tells you how 
much memory is left for your application program. If it is too small, you can 
either add more memory to your computer or install SuperKey with a smaller 
macro memory. The fourth line shows the size of the currently installed macro 
memory. 
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Main Menu 



Press 

I Alt f Tj (may be redefined, see page 90) 



Description 



Figure 7-13 shows the main menu, which is the window that appears at the top of 
the screen when you press I Alt M Tl. The main menu can be accessed at any time, 
even while you are defining a macro (as in the following example). 



CoMuaJz Functions Option leTnlti lacr^tlo* Uyoat Setif 



Figure 7-13 Main Menu 

You pull down a submenu from the main menu in the following ways: 

either use the Q and Q keys to move the highlighted bar to the desired 
item, then press l*^! to pull down the menu 

or press the capital letter in the item you want. For example, to pull 

down the options menu, press 

(aoLICO 

If you select by pointing with the bar and pressing (•♦-'I . you must press I Esc | to 
exit a menu. If you select by pressing letters, your choice is immediately exe- 
cuted, and you automatically exit the menu. This saves quite a few keystrokes. 

Once you have opened a pull-down menu, you can select an item in the same 
two ways you can use on the main menu: 

either use the (^ and (^ keys to move the bar to the item you want, then 
press (^-n to select that item. Then press [Esc| to exit the pull-down 
menu. 

or press the capital letter in the desired item. If you are in the Functions 

pull-down menu, you would press CX] to select the Time function. The 
Time function is then recorded in the macro, and you immediately exit 
the menu. 
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When you use this selection method, you don't press \-*-'\ to select the item, 
and you don't press lEscj to exit the pull-down menu. It is much faster than the 
first method, since it requires fewer keystrokes. 

In some cases, that's all there is to it. The Time function, for example, is 
entered into the macro just by choosing it. Other things on the menus require 
you to enter a value, for example the duration of a delay, or the default value of a 
command key. All menu items are described in detail throughout this section. 



m: <n> Text- rren <Alt-> to eU. 



Nacros CoMuaia 



Bcfaalts Encryption LaytMii Setup 



Mta 

Clear ecreee 
>eUi| facter 
Kavfcoar4 lock 



ratk 

leal ilea ielay 

Screes off 

icreea Oa 

Tiae 

cUt aa4 paata 



Figure 7-14 full-down Menu (Functions) 



Example 



To enter the Screen off function into a macro you are defining, press the follow- 
ing keys: 

Or, you could select from the menus by pressing the capital letters in the 
desired items: 

If you press these keys rapidly, you will just see the menus flash by on the 
screen. 

You can also combine the two methods. For example, select Functions by 
pointing, and Time by letter: 

(Airi(T;iQQe](Tj[Es^ 

In either case, the macro will look like this if you look at it in the macro editor: 

<CMD>FT<CMD> 
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Merge Macro 



Press 



Description 



The Merge macro command loads a macro contained in a disk file into macro 
memory without deleting other macros already there. Merging comes in handy 
when you have defined different macros in several sessions with your computer, 
but want to use the macros all at once. Only if macro memory and the file both 
contain a macro assigned to the same key will the old macro be deleted. 



To merge a macro file into memory, press I Alt f7~\ to get the main menu, then 
press [£] twice. The window shown in Figure 7-15 opens, requesting you to 
enter the name of the file you want to merge. The name you enter here can be 
any legal file name, optionally including a DOS path name (see page 123 for a 
discussion of file and path names). 



CoaaaWi Functio 



•rfultx hci^rtio* Lavoat SeUp 



Title 

Fixed Fieid 

Uir Field 

auto-start 
End 

clH aid paste 
el It 
Load 

EKTM FILE HflHE 

Cleap 
Save 



Figure 7-15 Merge Macro Window 
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Example 



The distribution disk contains three files, MERGEl.MAC, MERGE2.MAC, 
and MERGE3.MAC, which you can merge in diflPerent orders to get acquainted 
with the way merging works. Consider Mergel and Merge2 below, with charac- 
ters assigned to the function keys |F1 i - |F4 I : 

Key: (10 H:] dO dO 

Mergel ABC GHI 

MergeE DEF JKL 

If you first load Mergel into memory, then merge Merge2, the result will be: 

Key: (ID HO H^ 1|D 

Mergel ABC GHI 

Merges DEF JKL 



Memory: ABC DEF GHI JKL 



Now, if you merge a third file that contains a macro key already in memory, 
the existing definition will be replaced: 
Key: (TT) im (fTI [FT ) [F5~ | 



Memory: 
Merge3: 


ABC 


DEF 


GHI 

1S3 


JKL 


45t 


Memory: 


ABC 


DEF 


1S3 


JKL 


^5t 



See Also 



Load macro 
Save macro 
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One-finger Mode Option 



Press 

I Alt fT) [T| fo^ (or use /OO parameter on DOS command line) 



Default value 



OFF 
Description 



One-finger mode lets you enter commands that must normally be pressed simul- 
taneously as a sequence of keystrokes. This is useful if you can only use one hand, 
if you use a mouth stick, or if you have only one hand free for the computer at any 
one time. 

To switch ON one-finger mode, select Options on the main menu, then One 
finger on the pull-down menu that appears. You can then press l-<-^l to toggle the 
status to the opposite of its current value (OFF if it's ON and ON if it's OFF), or 
you can press Q or Q to explicitly turn one-finger mode ON or OFF. 



Example 



Use the following keystrokes to toggle one-finger mode on and off: 

or start SuperKey with this command: 

KEY /OO 

Now, if, for example, you want to reboot your computer using the ictnlAit \ (oeij 
sequence, you can press these three keys in sequence instead of holding down 
fctiTl and fAin and then pressing ^. 



See also 



Command line parameters 
Options 
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Options 



Description 



Options are SuperKey features that you can turn on or off whenever you need to. 
They are controlled from the Options menu. To reach them, press I Alt I TTI [o|J. To 
switch an option on and off, move the highlighted bar to it or press the capital 
letter in the name. Then press l-»-^l to toggle the status, or press Q or Q to 
explicitly switch the status to ON or OFF. Playback delay and proTect delay 
require a little extra information. A small window will open, prompting you to 
enter the necessary values. 
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Figure 7-16 Options Menu 

You can also control options with command line parameters when you start 
SuperKey. Each parameter on the command line must be followed by a [+3 or a 
Q to turn the option ON or OFF, and in the case of Playback speed and proTect 
delay, a number also. See page 77 for information about using command line 
parameters. 

If you want to make the new status of the options permanent, you can save 
your options by selecting Save options on the Options menu. 

Each option on the menu is described separately in this section. Table 7-6 lists 
all options, their default values, and the command line parameter you can use to 
set them (which, incidentally, are the same keys you press to access the options 
via the main menu). 
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Table 7-6 List Of Options 



Parameter Default Press 



Arrow keys 


/OA 


OFF 


(Air|D(UCii 


Bottom line 


/OB 


OFF 


CAiXD(T|(T| 


Command stack 


/OC 


ON 


[AirilTJ 1T| (TJ 


Format fields 


/OF 


OFF 


(AirxD(T](T] 


Keyboard click 


/OK 


OFF 


(AJTiri (TJ (T| 


proTect delay 


/OT 


OFF 


[AiXr|[0(XI 


One finger 


/OO 


OFF 


(AJTILI (T| dj 


Playback delay 


/OP 





(Air|r|(^(T| 


Real time delay 


/OR 





(Air|T;j(T|[0 


sUspend 


/OU 


OFF 


(AjTiLidJCll 


disk Wait 


/OW 


OFF 


fAiryr) fT) fw} 



Examples 



If you want to toggle keyboard click on, press these keys: 

or start SuperKey with this command: 
KEY /0K+ 
You could also make a macro that would toggle the option ON and OFF: 

(AitJ^ (AitJJ^ (AjTXO (IJ 1^ 



See Also 



Command line parameters 
Save options 
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Path Function 



Press 

(AiTxri CO [D 



Description 



Path is a function that can be included in a macro. When the macro is played 
back, the path name of the currently logged directory is displayed. (See page 123 
for a description of path names.) 

To enter a Path function into a macro, press fAin rn to activate the main menu, 
then select Functions, then Path. 



Example 



To make I Ait If Pl display the current path, enter 

(Aitj=;j (Ajyrj (AirjT^ 

If you look at this macro in the editor, it looks as follows: 
<CMD>FP<CMD> 
where the I Ait f H command is symbolized by <CMD>. 



See Also 



File names 
Functions 
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Playback 



Playback is the term used in this book to describe what happens when you press 
a key to which a macro has been assigned. 

SuperKey is hke a "tape recorder" placed between the keyboard and the com- 
puter. You can order it to "record" your keyboard activities, assign them to a 
single key, then order it to "play back" what you've recorded. 

The "recording" takes place either interactively or with the aid of the macro 
editor. The "recording" is stored in SuperKey's macro memory and can be just 
one character, or thousands of characters. 

When the key associated with the macro "recording" is pressed, the characters 
in macro memory are played back to the computer, just as if they had been 
entered on the keyboard. 



See Also 



Macro 
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Playback Delay Option 



Press 

I Alt f Tj [jo] (Tj (or use /OP parameter on DOS command line) 



Default value 



Description 



The Playback delay option controls the speed at which characters are transmitted 
by SuperKey. The default delay gives maximum speed, about 1000 characters 
per second. If your program cannot receive input at that speed — and many pro- 
grams can't, especially if the macro is long or contains many commands — then 
you must reduce the playback speed. You'll know you need to increase the play- 
back delay if your program beeps furiously at you, creates "garbage" on the 
screen, mixes up macros, or otherwise bungles things. 

To change the playback delay, first select Options on the main menu, then 
Playback delay on the pull-down menu. Now enter a number in the range 1 
through 999. You'll probably want to experiment with this number until every- 
thing runs smoothly. 

This number is not a time; it is the number of times SuperKey lets the receiv- 
ing program check the keyboard status before sending the next character. The 
actual delay varies depending on the program you're using. 
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Example 

Use the following keystrokes to set a playback delay of 10: 

(AO[r|(TJ(X||T|(T|(^ 

Or start SuperKey with this command: 

KEY /OPIQ 

See also 



Options 

Real time delay 

Save options 
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Protect Delay Option 



Press 

I Alt f Tj (^ (TJ (or use /OT parameter on DOS command line) 



Default value 



OFF 



Description 



Use the protect delay option to protect your screen against "burn in," which 
occurs if the same image is displayed for a prolonged period of time. The image is 
"burned in" to the screen, leaving a "ghost" impression even when the image is 
not there — and thereby damaging your monitor. When this option is ON, the 
screen goes blank after there has been no activity on the keyboard for a time you 
specify — (the protect delay). To turn the screen ON again, just press any key on 
the keyboard. Whatever was previously on the screen will reappear. 

To activate screen protection and set the protect delay, first select Options on 
the main menu, then protect delay on the pull-down menu. Then press l-^l to 
toggle the status to the opposite of its current value (OFF if it's ON and ON if it's 
OFF), or press [+jj or Q to explicitly turn the protect delay ON or OFF. 

When you toggle protection ON, an additional window opens, and you can 
enter the desired delay time or accept the displayed value by pressing l-^l . 

You'll probably want screen protection to be a permanent feature, so be sure 
to select Save options on the Options menu after specifying the delay. Other- 
wise, you'll have to do it again the next time you turn on your computer. 
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Examples 

Use the following keystrokes to toggle the status of the screen protection: 

(Airxr|(T|(Tj 

or turn it ON with this command line parameter: 

KEY /0T+ 

The following keystrokes turn ON screen protection and set the delay time to 
three minutes: 

(AjTiLKUITiQCOei 

and so does this command line: 

KEY /OT+3 

See also 



Options 
Save options 
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Pull-Down Menu 



Description 



A pull-down menu is a window that opens below the main menu, displaying 
various functions or features that you can select. Once you have opened a pull- 
down menu, you can select an item in the following ways: 



either 



or 



use the Q and Q keys to move the highlighted bar to the item you 
want, then press l-^i to select that item, or to turn it ON or OFF. You 
can also press Q to explicitly switch the function ON, or Q to switch 
it OFF. You can then move to another item on the pull-down menu. 
When you're through, press lEsc| to exit the pull-down menu and 
return to the main menu. 

press the capital letter in the desired item. If you are in the Options 
menu, you would press [^J to toggle the Keyboard click option to the 
opposite of its current status (ON or OFF). You exit the menu immedi- 
ately — you don't have to press l-^l or I Esc I . This method is faster than 
selecting by moving the bar, since it requires fewer keystrokes. 
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Figure 7-17 Pull-down Menu (Options) 

In some cases, that's all there is to it. The Time function, for example, is entered 
into the macro just by being chosen. Other things on the menus require you to 
enter a value, for example the duration of a delay, or the default value of a 
command key. How each item works on the pull-down menus is described sepa- 
rately in this chapter. 
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Examples 

If you want to make a macro to switch ON the Keyboard cHck option, press the 
following keys: 

(SLI Q Q (^ (^ □ □ □ □ (1] (10 (ID 

Or, you could select from the menus by pressing the capital letters in the 
desired items: 

(AjrjQCOdj 

If you press these keys in rapid succession, you will just see the menus flash by 
on the screen. 

You can also combine the two methods. Select, for example. Options by letter 
and click with the bar: 

(AiO[0(T|(T|(T|(T|(T](li^ 

The last lEsc| is to exit the main menu. 

See Also 



Main menu 
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Real Time Delay Function 



Press 



Description 



Real time delay is a function that can be included in a macro. When the macro is 
played back, playback pauses for the time you have specified. 

To enter a real time delay into a macro, press I Ait fTj (Tj (J^. A small window 
opens, requesting you to enter a time delay. Move the cursor with the Q and 
Q keys and enter a number from .10 (tenth of a second) to 99:59:59.99. 



See Also 



Delay function 
Functions 
Playback delay 
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Save Defaults 

Press 

I Alt fT) fT| fy) (or use /DS parameter on DOS command line) 



Description 



To save the currently selected defaults, press I Ait im to get the main menu, then 
press {^ and (J^. The current defaults setup is now saved in the KEY.COM file 
used to start SuperKey. To save defaults, this file must be present on the drive 
and directory that was active when you first started SuperKey. 



See Also 



Defaults 
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Save Macros 



Press 



[Alt f Tl (¥] (TJ (or use /MS parameter on DOS command line) 
Description 



The Save macros command saves all macros that are in macro memory in a file. If 
you want to use the macros you've been defining again — the next time you turn 
on your computer — you need to save them before you turn off your computer. 

To save macros, press I Ait f Tl to get the main menu, then press [m] and [^. A 
window opens, requesting you to enter the name of the file in which to save the 
macros. It's a good idea to use a name that suggests the purpose of the macros, 
such as CALCSTAR, DBASE, or the like. The name you enter here can be any 
legal file name, optionally including a DOS path name (see page 123 for a discus- 
sion of file and path names). If you do not specify a last name, the last name. 
MAC is automatically assumed. 
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Figure 7-18 Save Macros Window 



Example 



To save some macros you are using with Turbo Lightning, press (AJTJQ [¥J fs) . 
then type LIGHT l*^! . Now, the next time you use Turbo Lightning, you can 
load the LIGHT file into SuperKey's macro memory. 

You can also save the macros with the following command line parameter: 

KEY LIGHT /MS 

See Also 



Load macros 
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Save Options 

Press 

[Alt jCFj foj fs) (or use /OS parameter on DOS command line) 



Description 



To save the options you are using (on the Options menu), press I Ait j Ti. then 
press (^ and {^. The current options selections are now saved in the KEY.COM 
file used to start SuperKey. For your options to be saved, this file must be 
present on the drive and directory that was active when you first started 
SuperKey. 



See Also 



Options 
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Save Setup 

Press 

I Alt j Tl (^ [T| (or use /SS parameter on DOS command line) 



Description 



Any changes you make to the Setup menu (except macro memory size) become 
active immediately, but they are not permanently recorded in SuperKey. So if 
you want your new setup to take effect the next time you start SuperKey, you 
must first save it. 

To save the current setup, press I Ait j fTl to get the main menu, then press (^ 
twice. The current setup is now saved in the KEY.COM file which was used to 
start SuperKey. For the setup to be saved, this file must be present on the drive 
and directory that was active when you first started SuperKey. 



See Also 



Setup 
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Screen Off Function 
Screen On Function 



Press 



[Ayr] (T| (TJ (Screen off) 
OQ CLI (JD (Screen on) 



Description 



These are functions that can be included in a macro. When played back in a 
macro, they turn the screen off" and on, respectively. Unlike Clear screen, 
Screen off^ does not clear the contents of the screen — it only blanks it out tem- 
porarily. To turn the screen back ON, use the screen On function. 

To enter these functions into a macro, first activate the main menu (press 
I Alt j Tl). then select Functions, then Screen off or screen On. 



Example 



To make rAinrF9~| turn the screen OFF, enter: 

l^riQITyioiAir^ 

To make I Ait |Fio| turn the screen ON, enter: 

(AitJ=^(7ir}||ioj[Ai^ 
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Setup Menu 



Press 



Description 



Use the Setup menu to specify where SuperKey should look for its macro and 
layout files and files to be encrypted. 

The default setup does not specify any disks or directories, so SuperKey will 
look for its files on the currently logged disk and the currently active directory. 
But if you are using a hard disk and want your macros placed in a separate 
directory, or if you are using floppy disks and you can't fit the macro and layout 
files on your work disk, you can use Setup to tell SuperKey where to look for 
its files. 
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Figure 7-19 Setup Window 
Each item on the Setup menu is described separately in this chapter. 
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Examples 



Suppose your computer has two floppy disks, that you have all your programs, 
macro files, and layout files on your DOS system disk in the A: drive, and you are 
usually logged on the B: drive. Now you want SuperKey to find its files on the A: 
drive as well. Press 

If you want to record this setup permanently, press 

fAjTjfT] [T| fTj 

If you have a hard disk, you may want to collect all your macro and layout files 
in a separate directory, for example \MAC. To make SuperKey find its files here, 
press 

(aFIQ (T| (¥] \HflC ej 

Finally, let's look at the encryption directory. The default is the current direc- 
tory, so when you encrypt files, you will encrypt the files on the disk and direc- 
tory that is currently active. You can use Setup to select another directory if, for 
example, you have a directory called \MAIL where you keep your electronic mail; 
you can encrypt files in that directory regardless of where you currently are by 
entering 

rAinrri (T| (T| xmail ei 

This also ensures that you will not accidentally encrypt files in a wrong direc- 
tory. That can easily happen if encryption uses any currently active directory, 
because DOS does not ordinarily tell you where you are. There is a way to make 
DOS do that, however; check page 194. 

See Also 



Encryption directory 
Macro directory 
Macro memory size 
Save setup 
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Show Titles 



Press 

fAini Prtsc I (may be redefined, see page 90) 

Description 



The show tides command opens a window displaying the symbols and titles of all 
macros in memory. Figure 7-20 shows an example of a titles window. If there are 
more titles than will fit into a single window, you can page forwards and back- 



wards with I PgDn I and (W. 
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Figure 7-20 Titles Window 



See also 



Defaults 
Titles 
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Skip Key 

Press 

Q (may be redefined, see page 90) 

Description 



Use the skip key to access the original meaning of a key, temporarily bypassing 
the macro assigned to it. 

Thus, to bypass a macro, first press Q, then the desired key. The macro is 
skipped only this one time. The next time you press the key, the macro is played 
back. 

In the macro editor, the skip key has a slightly different effect. It is used to 
enter the editors function Ice ys into the macro (see page 101). 

The skip key is essential when you want to swap the meaning of one key for 
another. For instance, let's say you want to switch the (^ and [^ keys so that 
their meanings are reversed. When you redefine the [A^ key to (JjJ by typing the 
following: 

(AjOLI SI (Xl (IJ 11] (SQ 

you no longer have an [a^ key to define to the (former) (J^ key! You would use the 
skip key to "get the [a^ key back" temporarily, as follows: 

(SQ (1] (IJ (1] (Tj (Tj (Air^ 



Example 



You have assigned a macro to Ifi i . and now you need to use I pi I — the original 
|F1 I , not the macro — to access your application program's help system. Press 



See Also 



Defaults 
Edit macro 
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Stop 

Press 

I Ctrl I Esc I (may be redefined, see page 90) 



Description 



The stop playback command immediately aborts a macro that is being played 
back. It is useful if you have inadvertently invoked a long macro, or if you have an 
"infinite loop" — a macro that calls itself The only thing that will stop such a 
macro is the stop playback command. 
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Suspend Option 



Press 

I Alt f /~| [TJ [ju] (or use /OU parameter on DOS command line) 



Default value 



OFF 



Description 



Use the sUspend option to temporarily "switch oflT SuperKey. You might want to 
use sUspend when you need to temporarily reuse the original meanings of 
macros you've defined, or the original layout of your keyboard (if you've loaded a 
new layout). When suspension is ON, all macros become ineflPective, and the 
keyboard returns to normal, even if you have an alternate layout loaded. 

Press I Alt i n [^ {u^ to turn suspension on. SuperKey is now inactive, and can 
therefore not be activated again from the keyboard. To turn suspension OFF and 
reactivate SuperKey, you must therefore enter this command on the DOS com- 
mand line: 

KEY /OU 



See also 



Options 
Save options 
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Time Function 



Press 

(Air|TJ (T| (Tj 



Description 



Time is a function that can be included in a macro. When the macro is played 
back, the time is read from the DOS clock and displayed as a string of characters 
in this format: 

HH:MM:SS 

To enter a Time function into a macro, press I Ait f Tj. then select Functions, 
then Time. 



Example 



To make I Ait If Tl display the time, enter 

(AitJ^ (AirjTJ (wFJO (3 
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Titles 



Press 



I Alt in~| (may be redefined, see page 90) 

or rAirm fMi m 

Description 



Use Tides to give your macros names. This will help you remember what your 
macros are used for, and make it easier for others to use the macros you design. 
Once you have given a macro a title, it will be displayed along with the name of 
the key in the show titles window. 

After you have started a macro definition, press 

(Airxrj(UIT| 

or 

I Alt 



to create a title. A window appears, and you enter a descriptive title up to 30 
characters long. Press l-^l to end the title. 

If you want to add a title to an existing macro, you can use the macro editor 
(see page 101). 

Example 

The following keystrokes will give a title to the macro stored in |F7 | . 

(AjTiad:! 

(aFIQ Copy range of cells (^ 



See also 



Show titles 
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Variable Field 



Press 

\CMf -\ (may be redefined, see page 90) 

or rAirm rFi nn 

Description 



A variable field included in a macro defines a space into which you can enter text 
or numbers during macro playback. When you stop typing and press l-^-*! . macro 
playback resumes. 

A variable field is as long as what you type. Special characters (format and 
entry control masks) can be used to control what can be typed into a field, and 
how it is displayed on the screen. 

As long as your entry is not terminated, you can press l-^*"! (the backspace key) 
to delete characters from right to left. 

A variable field is terminated when you press l-^i . 

The maximum length of a variable field is 255 characters. 



Example 



The following keystrokes will establish a variable field in the macro in IF3 i - fol- 
lowing the words Product Description. 

Product description: (WjQ [ctr[)Q 



See Also 



Entry control 
Field formats 
Fixed field 
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E N D I X 



A 



Using SuperKey With Other 
Borland Products 



This appendix contains some suggestions for using SuperKey with Borland's 
other programs. If you're already a Borland veteran, you'll probably think of 
many other ways to use SuperKey in harmony with these programs. If you're not 
familiar with our other products, we hope this information will encourage you to 
try them out! 

SuperKey can enhance the performance oiany program, since it reduces your 
keystrokes. As examples, let's look at SideKick and Turbo Lightning for some 
SuperKey ideas. 



SideKick 



There are a couple of goodies for SideKick owners on the distribution disk, in the 
files GRAPH. MAC, GRAPH2.MAC, and TAPE. MAC. 
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GRAPH MAC and GRAPH2.MAC 



These two sets of macros turn the numeric keys on the numeric keypad into 
semi-graphic characters. With the SideKick Notepad in Graphic mode (press 
I Ctrl If ol fGl ). you can now enter lines and corners for frames, flow diagrams, and 
the hke. 

Press fAiryT) (¥j (T| GRAPH SJ 

to load the file GRAPH. MAC. 

With [ctr^ pressed, the numeric keypad now produces single lines, and if you 
press I Alt i . it produces double lines. 

GRAPH2.MAC contains a secondary character set with symbols that combine 
single and double lines. Once the GRAPH file is loaded, you can switch between 
the two by pressing 

rAinnns 



TAPE. MAC 



This set of macros makes the SideKick Calculator use the Notepad as a "paper 
tape." When you load this macro, the Notepad will record all calculations per- 
formed with the Calculator. (Whatever you've previously written in the Notepad 
will remain undisturbed.) 



Calling SideKick with SuperKey 



You normally activate and exit SideKick by pressing a combination of the 1-^ I - 
(£r[J, and [AiO keys — for example (WJW^ or (^I^. Since these shift-state keys 
cannot be recorded in macros by themselves, this method cannot be used to 
activate SideKick from a macro. 

SuperKey therefore uses its own command to activate and leave SideKick. 
You'll find this command on the Commands menu. Press 



(Mjr|[rj(T| 
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Examples 

This macro will alternately activate and exit SideKick: 

(aF|T)(X|(I] 



This macro will activate SideKick, enter the Notepad, and go to the bottom of 
the note file: 



[AirxLj(T|(T| 



The SideKick Notepad is a great way to create and edit macros, too (see 
page 58). 



Turbo Lightning 



SuperKey macros can help you speed up Turbo Lightning's functions. This is 
especially useful for functions that you want to turn OFF and ON frequently. For 
instance, you may want to switch between screen and keyboard mode (selection 
M on the Edit Environment menu). We've included a macro to do this for you, 
under the file name KEYBOARD. MAC (Turbo Lightning Install/Supplemental 
Files Disk). This macro will let you toggle where your application receives its 
input — from the screen or the keyboard. After loading KEYBOARD. MAC, just 
press I Alt |F4 I when you want to change back and forth between keyboard and 
screen mode. This macro saves you five keystrokes. 

You could set up another macro that would change to screen mode and check 
the word at the cursor; the macro would need to include this key sequence: 

After using this macro, you could then use the KEYBOARD. MAC macro 
C I Alt |F4 I ) to switch back to keyboard mode. 

You're certain to come up with other macros as you use Turbo Lightning and 
discover which of its functions you use most often. 
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A Note for Reflex Users 



SuperKey will not work properly with Reflex versions earlier than 1.11. If you 
have an early version of Reflex and want to use it with SuperKey, contact Borland 
for an update. 
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APPENDIX 



B 



Using SuperKey With Batch Files 



The AUTOEXEC.BAT File 



Starting SuperKey is as simple as typing KEY l-<-'l on the DOS command line. 
But if you are using an AUTOEXEC.BAT file to start up your system, you might 
as well include SuperKey in it. (If you don't know what an AUTOEXEC.BAT file 
is, see Appendix E, "A DOS Primer." 

It is essential that SuperKey be loaded into your system according to the 
following sequence if you are using other resident programs: 

• Load any non-Borland resident programs first (print spoolers, RAM 
disks, etc.). 

• Load SuperKey next. 

• If you have it, load Turbo Lightning. 

• Finally, if you have it, load SideKick last. 

Let's say you have an existing AUTOEXEC.BAT file that automatically loads a 
print spooler (spool) and your word processing program (wp) when you start up 
your computer. In addition, you are a SideKick owner. The file might look like 
this (assuming you use tree-structured directories; if you don't use directories, 
the CHDIR command is not necessary): 
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spool 

sk 

chdir / wp 

ws 

To include SuperKey in your AUTOEXEC.BAT file, you must insert it after 
the spool program, but before SideKick. Borland's SideKick must always be the 
last resident program loaded into your system. The following commands will do 
the trick: 

copy con: autoexec.bat El 
spool El 
chdir/ light ei 
light ei 

skei 
chdir / wpEl 

wsei 

Now, the next time you turn on your computer, SuperKey will be automati- 
cally loaded at the right time. 



Loading Macros with ,BAT Files 



If you have a macro file for each program you use, it's a good idea to make a batch 
file that automatically loads the right macro file, then starts the program, and 
finally clears the macros from memory when you exit the program. 

Here is an example .BAT file for Lotus 1-2-3: 

KEY 123 /ML 
LOTOS 
KEY /MC 

The reason to clear the macros when you exit is that some macros may have 
unwanted eflPects if used inadvertently in the wrong programs. 

Of course, .BAT files can do much more than load macro files. In fact, you can 
pass almost any command to SuperKey on the DOS command line. Please see 
page 77 for a full description of all command line parameters. 



182 SuperKey Owner's Manual 



APPENDIX 



c 



Installation 



This appendix tells you how to use the KEYINST.COM installation program to 
custom-configure SuperKey for your computer. Although SuperKey is automati- 
cally set up for an IBM PC or compatible, you may want to change some of the 
default settings in the program. If you want to install SuperKey on a PCjr, type 
PCjr on the DOS command line before using SuperKey the first time. 
KEYINST allows you to do the following: 

• Change the monitor type. 

• Change the colors of SuperKey 's windows. 

• Change macro memory size (the amount of space reserved for storing macros 
in your computer's memory). 

Note: If you are using a one-color monitor with a graphics video board, type 
MODE BW80 on the DOS command line before running KEYINST 

During installation, all KEYINST files and the KEY.COM and 
KEYDES.COM files must be on the logged drive. To start installation, type 

KEYINST ei 

The menu in Figure C-1 now appears on your screen. Unless you are using 
the DES encryption scheme (see page 104) choose KEY.COM. After you have 
chosen the SuperKey file to install, press l-^-*! and the main installation menu 
will appear. Use the Q and Q keys to move to the item you want to change, 
then press l-^i . 
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Figure C-1 First Installation Screen 
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Figure C-2 Installation Main Menu 



Screen Type 



When you select Screen on the Installation menu, another pull-down menu 
appears which allows you to select the screen mode you want SuperKey to use. 

Choose one of the following display modes by moving to it with the Q and Q 
keys, then press l-^l . 
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Default display mode 



By default, SuperKey will always operate in the mode that is active when you 
load it. If you change the screen mode later, SuperKey will still use the mode 
which was active when you loaded it. SuperKey always uses 80x25 character 
mode even if 40x25 is active, and it will use color mode if graphics mode is 
active when you loaded it. 



Monochrome display 



SuperKey will use monochrome mode, no matter what mode is active, and 
switch back to the active mode on exit. 



Color display 80x25 



SuperKey will use color mode with 80x25 characters, no matter what mode is 
active, and switch back to the active mode on exit. 



B/W display 80X25 



SuperKey will use black and white mode with 80x25 characters, no matter what 
mode is active, and switch back to the active mode on exit. 

At the bottom of the Screen Installation Menu are two questions you may 
need to answer: 



Blinking display? 

If you installed a monochrome display, you don't need to answer this question. A 
standard IBM color/graphics controller blinks when it scrolls, but some other 
controllers don't. Answer Y or N as appropriate. This causes SuperKey to use 
your video controller with as little screen flicker as possible. 
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Blank background? 

When you select default or color screen mode, you will be asked whether you 
want the background cleared in graphics mode; default is Y (YES). When you use 
SuperKey in color graphics mode, the screen background will fill up with flash- 
ing "modern art" characters when you call up the menus. If you don't mind this, 
you can save 4K of RAM by answering N (NO) to this question. 



Colors 



The Colors selection on the Installation Menu allows you to change the colors 
(and monochrome attributes, if you have a monochrome monitor) used for win- 
dow frames and text in SuperKey. The standard colors and attributes have been 
carefully chosen to provide clear and informative screen images with standard 
IBM video controllers and monitors. Some other controllers and monitors, how- 
ever, may display colors diflPerently, so you can use this installation to design the 
windows to look their best with your particular hardware. 

The Colors installation first lets you choose which of SuperKey's windows you 
want to install. Select from the menu with the arrow keys, then press I'^l . 

To the right, you'll see a set of sample windows. Each window has three sepa- 
rate areas, and the selected area will be blinking. The Q and Q keys select an 
area. When the area you want to re-color blinks, press l-^l to chose a new color. 
The area will then stop blinking, and a bright frame will appear around the 
current color of that area. You can move this frame around to select a new color. 
The sample window to the right shows the colors as you move the frame. 

If you install a monochrome screen, your choice is limited to five different 
video attributes. 

When you've decided on a color, press lEscj to return to the sample windows. 
Now you can select another area to color. When you're satisfied with all the 
colors you've chosen, press I Esc | to exit to the window selection menu. 

You can then choose another window to color, or press |F2 | to save the colors 
you've chosen. If you change your mind about the colors and want to exit without 
saving them, just press I Esc | . 

The changes you've made only aflFect the SuperKey files on disk; the SuperKey 
you may have already loaded into your computer's internal memory is not 
installed. You have to re-load SuperKey and start again to see the new colors. 
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Macro Memory Size 



SuperKey normally sets 8000 bytes of memory aside for macros. If you want to 
preserve memory, and you only plan to use a few or short macros, you can 
change this value to something smaller. On the other hand, if you have lots of 
memory, you can set as much as 65536 (64K) bytes aside for macros, and you will 
probably never run out of macro memory. 

Press (^ to change macro memory size, and enter the new size as desired 
(in the range 128 through 65536). See page 145 for a full explanation of macro 
memory. 
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.MAC Files on the Distribution Disk 



Following are the ready-to-use .MAC files on your distribution disk. To use a 
.MAC file, press 

(AJTKTJdKTj 

to load the file into SuperKey's macro memory. Type in the name of the file you 
want to use; you don't have to type .MAC. 



123. MAC 
123TRNSP.MAC 

BASICA.MAC 
DOS. MAC 

DOSTRNSP.MAC 

EDIX.MAC 
FOREIGN. MAC 

GRAPH. MAC 

GRAPH2.MAC 
INVENT4.MAC 



Macros to be used with LOTUS 1-2-3. 

Same macro file as 123. MAC but with the transparent 

«TRANSP)) command included. 

Macros to be used with BASICA. 

Macros that make common DOS commands a little easier 

to use. 

Same macro file as DOS. MAC but with the transparent 

((TRANSP)) command included. 

Macros to be used with EDIX. 

Macros that allow you to use the letters most commonly found 

in foreign languages. 

Macros that allow you to use extended ASCII characters to do 

graphics. 

More macros for graphics. 

A macro demonstrating what beautiful music you can make 

with SuperKey's sound capability. 
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LUNCH. MAC 
MERGEl.MAC 

MERGE2.MAC 
MERGES. MAC 
SUPCALC3.MAC 
TAPE. MAC 

TAPEOFF.MAC 

TURBO. MAC 

VISICALC.MAC 

VOLKSWTR.MAC 

WORDIX.MAC 

WORDPER.MAC 

WS.MAC 



A macro that demonstrates keyboard lock. 

Macros that demonstrate SuperKey's merge facihty (explained 

on page 148). 

Another merge macro. 

Another merge macro. 

Macros to be used with SuperCalcS. 

Macros to be used with SideKick's calculator that allow you to 

use the Notepad as a tape. 

Macro that allows you to turn TAPE on and off 

Macros to be used with Turbo Pascal. 

Macros to be used with Visicalc. 

Macros to be used with Volkswriter. 

Macros to be used with Wordix. 

Macros to be used with Word Perfect 4.0. 

Macros to be used with WordStar. 
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A DOS Primer 



If you are new to computers or the DOS (MS-DOS or PC-DOS) operating sys- 
tem, you may have trouble understanding certain terms used in this manual. 
This appendix will give you a brief overview of the following DOS concepts and 
functions: 

• What DOS is and does 

• The proper way to load a program 

• Directories and subdirectories 

• Using AUTOEXEC.BAT files 

This information is by no means a complete explanation of the DOS operating 
system. If you need more details, please refer to the MS-DOS or PC-DOS user's 
manual that came with your computer system. 



What Is DOS? 



DOS is shorthand for Disk Operating System. MS-DOS is Microsoft's version of 
DOS, while PC-DOS is IBM's rendition. DOS is the traffic coordinator, man- 
ager, and operator for the transactions that occur between the parts of the com- 
puter system and the computer system and you. DOS operates in the 
background, taking care of many of the menial computer tasks you wouldn't want 
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to have to think about. But it's ready to leap to the foreground when you need 
it — that is, when you want to give it a command. 

Some DOS transactions are invisible to you — ^for instance, the flow of charac- 
ters between your keyboard and the computer, between the computer and your 
printer, and between your disk(s) and internal memory (RAM). Other transac- 
tions are ones that you initiate — by entering commands on the DOS command 
line; in other words, immediately after the DOS prompt. Your DOS prompt 
looks like one of the following: 

A> 
B> 
C> 

The capital letter refers to the logged disk (the one DOS and you are using 
right now). For instance, if the prompt is A>, it means you are working with the 
files on Drive A, and that commands you give DOS will refer to this drive. When 
you want to switch to another disk and make it the logged disk, all you do is type 
the letter of the disk, followed by a colon and a l-^l . For instance, to switch to 
Drive B, just type B:^}. 

There are a few commands that you will use often with DOS, if you haven't 
already: 

DEL or ERASE To erase a file 

DIR To see a list of files on the logged disk 

COPY To copy files from one disk to another 

KEY To load SuperKey 

DOS doesn't care whether you type in upper or lowercase letters, or a combi- 
nation of both, so you can enter your commands however you like. 

We'll assume you know how to use the first three commands listed above; if 
you don't, refer to your DOS manual. Next, we will explain the proper way to 
load a program like SuperKey, and that involves the last command — KEY. 



How to Load a Program 



On your System Disk, you'll find the main SuperKey program, under the file 
name KEY.COM. This program is necessary for all SuperKey functions, so you 
always need it when you first start the program. A file name with the "last name", 
or extension .COM or . EXE means a program file that you can load and run (use) 
by typing its "first name" on the DOS command line. So, to invoke SuperKey, 
you simply type KEY l-^-*! and SuperKey will be loaded into your computer's 
memory. 
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Easy, right? It is, but there's one thing you need to remember about loading 
SuperKey and other similar programs: you must be logged on the disk and direc- 
tory where the program is located in order to load it; otherwise, DOS won't 
know where to find the program. 

For instance, if your System Disk with the KEY.COM program is in Drive A 
but the prompt you see on your screen is B>, DOS won't know what you're 
talking about if you type KEY l-^-*! and will tell you 

Bad command or file name 

It's as if you were shuffling through the "School Records" file in your file cabi- 
net looking for information about your home finances. You're in the wrong place. 
So if DOS gives you that message, all you have to do is switch to Drive A by 
typing A:SJ. Then type KEY 1^ to load SuperKey. 



Directories 



A directory is a convenient way to organize your floppy or hard disk files. DOS 
allows you to subdivide your disk into sections, much the way you might put 
groups of manila file folders into separate file boxes. For instance, you might 
want to put all your file folders having to do with finance — for instance, a bank 
statement file, an income tax file or the like — into a box labeled "Finances." 

On your computer, it would be convenient to make a directory to hold all your 
SuperKey files, another for your SideKick files, another for your spreadsheet, 
and so on. That way, when you type DIR on the DOS command line, you don't 
have to wade through hundreds of file names looking for the file you want. You'll 
get a listing of only the files on the directory you're currently logged on. 

Although you can make directories on either floppy or hard disks, they are 
used most often on hard disks. This is because a hard disk can hold a much 
greater volume of data, so there is a greater need for organization and compart- 
mentalization. 

When you're at the DOS level (rather than in SuperKey or another program), 
you can tell DOS to create directories, move files around between directories, 
and show which files are in a particular directory. 

In the examples that follow, we assume you are using a hard disk system, and 
that you are logged onto the hard disk so that the prompt you see on your screen 
is C>. If you want to create directories on your floppy disks, just substitute A or 
B for C in the example. 
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To make a directory especially for all your SuperKey files, do the following: 

• At the C> prompt, type MKDIR KEY EJ. The MKDIR command tells DOS 
to make a directory called KEY. 

• Type CHDIR KEY EJ. The CHDIR command tells DOS to move you into 
the KEY directory. 

• Now, put the SuperKey disk you want to copy from into one of your floppy 
drives — let's say A for this example — and type COPY A: * . * l-^-*! . (The aster- 
isks are wild cards that stand for all files.) The COPY command tells DOS to 
copy all files on the A drive to the KEY directory on the C drive. As each file 
on the disk is copied, you will see it listed on the screen. 

That's all there is to it. Treat a directory the same way you would a disk drive: 
to load SuperKey, you must be in the KEY directory before typing KEY l-^-*! . or 
DOS won't be able to find the program. 



Subdirectories 

If you are someone who really likes organization, you can further subdivide your 
directories into subdirectories. You can create as many directories and subdirec- 
tories as you like — just don't forget where you put your files! 

A subdirectory is created the same way as a directory. For instance, to create a 
subdirectory from the KEY directory (for instance, for storing your macro files) 
do the following: 

• Be sure you are in the KEY directory. 

• Type MKDIR MACROS Si. 

• Type CHDIR MACROS. You are now in the MACROS subdirectory 

If you do put your macro files in a subdirectory, just remember to let Super- 
Key know where they are using the Setup menu. 



Where Am I? The $p $g Prompt 



You probably have noticed that when you change directories, you still see the 
C> prompt; there is no evidence of what directory or subdirectory you are in. 
This can be confusing, especially if you leave your computer for a while. It's easy 
to forget where you were when you left. 

DOS gives you an easy way to find out. Just type prompt=$p $g and from now 
on (until you turn your computer off or reboot), the prompt will show you exactly 
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where you are. Try it. If you are still in the MACROS subdirectory, your DOS 
prompt should look like this: 

C:\KEY\MACROS ) 
The AUTOEXEC.BAT file 

In the example above, every time you turn on your computer, you must type the 
prompt command if you w^ant to see where you are. If you'd rather not do this 
every time, you can set up an AUTOEXEC.BAT file to do it automatically each 
time you turn on your computer. 

The AUTOEXEC.BAT file is a useful tool to get your computer to do things 
automatically. We won't go into great detail here — see your DOS manual for 
more information — but we will show you how to create an AUTOEXEC. BAT file 
that will automatically change your prompt so you know where you are in your 
directory structure, and then load SuperKey. 

If you have an AUTOEXEC.BAT file in your root directory, your computer 
will do everything in that file when you first turn your computer on. (The root 
directory is where you see the C> or C:\ prompt, with no directory names fol- 
lowing it.) 

Here's how to create an AUTOEXEC.BAT file. 

• Type CHDIR \ (^ to get to the root directory. 

• Type COPY CON AUTOEXEC.BAT E|. This tells DOS to copy whatever 
you type next into a file called AUTOEXEC.BAT. 

• Type: 

ECHO OFF 
PROMPT=$P $G ej 
CHDIR \KEY ej 
KEY^J 

The (ctrlJTJ sequence saves your commands in the AUTOEXEC.BAT file. 

To test your new AUTOEXEC.BAT file, reboot your computer by holding 
down the I Ctrl | and I Alt I keys and then pressing (£eij. This is what you should see: 

C:\KEY 
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Changing Directories 



How do you get from one directory to another? It depends on where you want 
to go. The basic DOS command for changing directories is CHDIR. Use it as 
follows: 

To move from one directory to another: For example, say you want to change 
from the KEY directory to one called WP. From the KEY directory, type 

C:\KEY> CHDIR \WP ^} 

Notice the backslash (\) before the directory name. 

To move from a directory to its subdirectory: For example, you want to move 
from the KEY directory to the MACROS subdirectory. From the KEY directory, 
type 

C:\KEY> CHDIR MACROS SJ 

In this case, you did not need the backslash, because the MACROS directory 
is a direct offshoot of the KEY directory. In fact, DOS would have misunderstood 
what you meant if you had used the backslash in this case. If you had included 
the backslash, DOS would have thought that MACROS was a directory off the 
main (root) directory. 

To move from a subdirectory to its parent directory: For example, say you 
want to move from the MACROS subdirectory to the KEY directory. From the 
MACROS subdirectory, type 

C:\KEY\MACROS> CHDIR .. (^ 

DOS will move you back to the KEY directory. Anytime you want to move 
back to the parent directory, use a space, followed by two periods after the 
CHDIR command. 

To move to the root directory: The root directory is the original directory. It is 
the parent (or grandparent) of all directories (and subdirectories). When you are 
in the root directory, you see this prompt: 

C:\> 

Anytime you want to go there, simply type 

CHDIR \ (S 

The backslash without a directory name signals DOS that you want to return 
to the root directory. 

This has been a quick look at moving around between directories. It is cer- 
tainly enough to allow you to get around on your disk. For more information, see 
your DOS manual. 
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We hope this clears up any confusion you may have regarding DOS. Once 
you're famihar with the information given here, you may want to study your 
DOS manual and discover the many things you can do with your computer's 
operating system. There are many other DOS functions not mentioned here that 
can simplify and enhance your computer use. 
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HELP!!! 



This appendix provides answers to the most commonly asked questions about 
Super Key. 

Q: What is the exact loading order if I want to load SuperKey, Side Kick, and 
other memory-resident programs, such as RAM disks and print spoolers? 

A: SideKick is always the last program to be loaded into memory, and 
SuperKey gets loaded just before SideKick (unless you use Turbo Lightning — 
see below). So, if you use other memory-resident programs, you load them 
before SuperKey and SideKick. A typical loading sequence would be: 

Clock 
RAM Disk 
Print Spooler 
SuperKey 
Turbo Lightning 
SideKick 

Q: The Functions Menu is not available when I bring up SuperKey's main 
menu with I Alt ITl. 



A: Until you define macros, the Function menu is not available; the func- 
tions are for inclusion in the macros you define. They do nothing by themselves, 
but are available once you start defining a macro. Try again by starting a macro 
definition, then press I Alt fr\ to bring up SuperKey's main menu, and then press 
[Tl for functions. 
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Q: When I play back a macro, something seems to be wrong as far as timing 
goes. The commands don't correspond to the prompts the computer is giving. 

A: You should use delays when "playing back" macros. You do not always 
have to use delays, but when your application needs to pause, SuperKey needs 
to know this. A good example is when you are exiting WordStar. After pressing 
the X key to exit, anything you type is lost in the "bit bucket" until you get the 
DOS prompt back. There is no set rule for using delays, but to determine which 
delays your particular macro requires, simply play back the macros manually and 
notice where pauses are required and how long they should be. You can then 
determine the appropriate delays. 

Q: With SuperKey loaded, I cannot use I Ait \ with the numeric keypad to 
enter a string of ASCII characters. 



A: For SuperKey to be able to define keys like fAin PgDn I . the standard use of 
I Alt I with the numeric keypad is modified. While SuperKey is resident, use the 
1 -^ i Alt I keys in conjunction with the numeric keypad to enter a string of ASCII 
characters. 

Q: While I am defining a macro, if I bring up the Defaults Menu, I cannot 
see the actual key sequences for default commands, but only their titles. 

A: The actual key sequences for default commands are not shown while you 
are creating a macro, so you won't get confused as to what the current key 
sequence is. If they were shown, they might not reflect changes made to them 
by other macros. This function is here so you can change default command key 
sequences "on-the-fly," but not while defining a macro. 

Q: What is the difierence between text mode and nontext mode encryption? 

A: In a nutshell, if you wish to encrypt a file and leave no traces of an original 
on your disk, use the default mode or answer N to the question "Text Mode?". If 
you wish to encrypt a file after making a copy of it, first use "Text Mode" encryp- 
tion or answer Y to the question "Text Mode?". Text mode encryption is espe- 
cially useful for changing binary files to encrypted text files for transmission 
across phone lines via modem to a bulletin board, Easy-Link, CompuServe or to 
another friend with a modem, etc. 

Q: After I invoke a command from the main menu, sometimes the menus 
disappear and sometimes they stay there. Why? 

A: If you use the cursor to select items from the menu, you are using novice 
mode, which makes the menus stay until you I Esc I out of them. If you use the 
letter of the commands instead of the cursor, the menus disappear immediately 
after issuing each command. This helps both first-time and expert users get 
maximum benefit from the pull-down menus. 
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Q: My display window shrinks when I add more text. Why? 

A: As your total macro size grows closer to the "maximum macro memory" 
size (which defaults to 8000 characters, and is installable with KEYINST from 
1000 to 64000 characters), the display window shrinks to conserve macro mem- 
ory space, so that the macros function properly. 

Q: I cannot use one-finger mode to invoke SideKick. 

A: You must have SideKick 1.5 or greater to make use of one-finger mode. 

Q: When I use one-finger mode to invoke SideKick, the screen flashes Side- 
Kick on and off. 

A: You must press another key after pressing ictnlAit | . because SuperKey 
remembers the status of the last-pressed key, and thinks you are still pressing 
I Ctrl I Alt I until you press something else! 

Q: When I run KEYINST with a color graphics card and a composite video 
one-color monitor (black and white), the display looks grainy. 

A: Insert your DOS disk and type MODE BW80 on the DOS command line 
before running KEYINST. Then — using KEYINST— make sure you install your 
screen type for black and white. 

Q: When I use either Protect Delay or Screen On/Screen Off, only the cur- 
sor turns off, not the whole screen. 

A: If your video board is not an IBM video board, chances are it is a "non- 
blinking" video board. To determine if your video board is a "non-blinking" video 
board, perform the following test: hold down the l-^l key (at the DOS prompt) 
and continue holding it down as the screen fills up with prompts. If prompts 
scroll off the screen smoothly and the whole screen DOES NOT blink with 
each scroll, then you have a "non-blinking" video board. If this is the case, 
you must run the installation program KEYINST and select "Change Screen 
Type." When asked the question "Does your screen blink when it scrolls (y/n?)", 
answer "N." 

Q: When I use Screen Protect, the manual says I can strike any key to bring 
back the display. But when I do, the key I strike is passed through to the pro- 
gram — causing unexpected results. 

A: Any key you press to reactivate the screen will be passed through. The 
solution to this problem is to press keys that do not produce a character by 
themselves, e.g.: 

(Alt) 

(Shift) 

(Ctrl) 
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The following keys should be used WITH CAUTION — ^because pressing them 
changes their status: 

(Caps Lock) 

(Numlock) 

(ScrollLock) 

Q: When I call up SuperKey over a graphics screen (like Reflex), the screen 
turns into a pattern of nonsense characters. 

A: This is because SuperKey has changed your display from graphics to text 
mode. When you I Esc I out of SuperKey, your display will return to normal. If you 
don't like this eflPect, use the KEYINST program to blank the screen in graphics 
mode; see Appendix C. 

Q: I cannot page down through display macros that are larger than one page. 
When I press I PgO" I while the first display window is up on the screen, the dis- 
play simply disappears. 

A: The macro must be a transparent display macro. The command 
(TRANSP) is present somewhere in the file. With transparent display macros, 
only one display screen can be shown. iPfl^Pl and I PgO" i do not afiiect these display 
macros; instead, the keystrokes get sent through to the underlying application. 
For more information about transparent display macros, see page 48. 
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Glossary 



autO-start macro: A macro that executes (plays back) automatically each time 
the file containing it is loaded. 

beep function: Function that can be included in a macro to produce a sound tone 
of a certain frequency and duration, 

burn-in: Damage caused to a computer screen when the same image is shown on 
the screen for an extended period of time. The screen's phosphor becomes 
"worn" in places where characters are displayed, and faint images are seen on the 
screen even when it is turned oflp. 

command line parameter: One or two letters, preceded by a slash and possibly a 
file name, used to give commands to the operating system. It is possible to load 
SuperKey and give it instructions through command line parameters, instead of 
using the SuperKey main menu. 

command stack: Area in your computer's memory that contains the last 256 
characters you have entered while in DOS; the stack is accessible at any time 
from SuperKey, to allow you to re-execute any command without having to re- 
enter characters. 

cut and paste: SuperKey feature that allows you to take (cut) anything displayed 
on the screen and include (paste) it in a macro. 

decryption: Method used to unscramble an encrypted file, by way of a keyword. 

default commands: Macro values assumed by SuperKey when no other values 
are specified. 
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DES encryption: Maximum-security encryption method that complies with the 
DES (Data Encryption Standard) issued by the U.S. National Bureau of Stan- 
dards. Because it protects your data from even the most sophisticated code- 
breaker, it is slower than the other encryption method oflFered by SuperKey. 

disk Wait: SuperKey option that prevents SuperKey from sending any charac- 
ters to disk while the disk is spinning. This protects you from inadvertently 
losing data on a floppy-disk machine. 

display macro: SuperKey macro that is not sent to the keyboard, but is simply 
displayed on the screen. You can create display macros with a text editor of your 
choice, to write your own customized, on-screen help text for yourself or other 
users. 

encryption: Method used to scramble the contents of a file so that it is unusable 
by unauthorized users — i.e., those that don't know the keyword that will 
decrypt (unscramble) the file. SuperKey offers two methods of encrytion: a fast 
algorithm contained in the KEY.COM file that should be used for files that are 
not of an extremely sensitive nature; and a slower, DES file encryption algorithm 
contained in the KEYDES.COM file, to be used for encrypting higher-security 
data. 

entry mask: Special characters that you enter into afield to control the type of 
characters — numeric, alphabetic, uppercase or lowercase — that may be con- 
tained in a macro. 

field: A special set of characters included in a macro that will stop playback of the 
macro, to allow you to enter a value that controls the contents and display of the 
macro. See entry mask and format mask. 

fill character: Character used to "pad" a fixed field if it is not completely filled in. 
Fill characters are blank spaces by default, but can be specified to be any other 
displayable character. 

fixed field: Set of characters included in a macro that defines a space of a speci- 
fied size, into which you can enter characters during macro playback. See vari- 
able field, format mask and entry mask. 

format mask: Special characters that you enter into afield to control the way the 
macro is displayed — left adjusted, right adjusted, centered, or with numeric 
formats. 

interactive macro definition: SuperKey feature that allows you to define macros, 
using the Begin Macro command, while you are working with an application 
program other than SuperKey. 

keyboard buffer: Area in your computer's memory that stores up to 16 
keyboarded characters. The buffer allows you to type and store characters even 
while the computer is busy reading or writing to disk. SuperKey expands this 
buffer with its type-ahead buffer. 
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keyword: Sequence of characters, up to 30 characters in length, that is used to 
encrypt and decrypt files. 

layout file: File that contains the format (layout) of your keyboard. This layout 
can be re-defined using the SuperKey layout editor 

macro: One or more characters that can be recorded in macro memory by Super- 
Key and assigned to a single key. Each time that key is pressed, the recorded 
characters are played back, as if they had been entered on the keyboard. 

macro editor: SuperKey feature that allows you to create new macros and edit 
ones you've already created. 

macro memory: Area of your computer's internal memory (RAM) that SuperKey 
reserves for storage of macros. 

macro file: A file with a . MAC extension that contains a SuperKey macro defini- 
tion. This file can be loaded into the computer via the Macros menu. 

nested macro recording: Method of storing macros in which one macro is 
recorded while another is being played back. 

non-text mode encryption: Mode of encryption in which the encrypted file is 
written directly on top of the original, unscrambled file, so that no part of the 
original file is available on disk. See text mode encryption. 

one-finger mode: SuperKey feature that changes commands which normally 
require you to press two or more keys at the same time, into a sequence of single 
keystrokes. 

path: Part of a file name, given on the DOS command line, that specifies sub- 
directories which lead to the file in a DOS tree-structured file directory. 

playback: SuperKey function that enables you to press a key to display and/or 
execute the macro that was recorded (in macro memory) for that key. 

playback delay: SuperKey option that controls the speed at which macros are 
transmitted to a program; playback delay is used to slow down transmission for 
programs that cannot receive input at SuperKey s default speed of 1000 charac- 
ters per second. 

resident program: Application program, such as SuperKey or SideKick, that is 
loaded into your computer's main memory, and stays there and remains available 
for your use until the computer is turned oflp. 

root directory: Main directory, which may contain subdirectories, in a DOS 
tree-structured file directory. 

shift-state key. The ALT, CTRL, or left or right hand SHIFT key. One of these 
keys is held down while pressing any other key on the keyboard to create some 
SuperKey macros. 
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status line: Top line of the macro eDitor screen that provides information about 
the macro you are currently editing. 

text mode encryption: Mode oi encryption in which the encrypted file is a sepa- 
rate file consisting of all uppercase characters that can be sent and received by 
communications programs that don't handle binary files; the original (unscram- 
bled) file remains untouched and not protected from unauthorized disk access. 
See non-text mode encryption. 

toggle: To turn a feature or function ON and OFF, often using the same key. 

transparent macro: A display macro that clears when the user presses any key. 

tree-structured directory: The way DOS organizes files. Some files are con- 
tained in root directories, which may branch to subdirectories that contain other 
files. 

type-ahead buffer: SuperKey feature that expands your computer's normal 16- 
character keyboard buffer to 128 characters. This allows you to type up to 128 
characters, even while the computer is reading or writing to disk. 

variable field: Set of characters included in a macro that define a space into 
which text or numbers can be entered during macro playback. The variable field 
definition does not specify the length of the field; it will be as long as the entry. 
See fixed field, entry mask, and fiyrmat mask. 
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Arrow key defaults, 64 
Arrow keys option, 66 
AUTOEXEC.BAT file, 181, 195 
Auto-start macros, 21 , 43-44, 68 

B 

Batch files, 181 
Beep function, 69 
Begin macro, 13, 71 
Bottom line option, 31, 73 



Clear macros, 19, 74 

Clear screen function, 76 

Colors, 186 

Command line parameters, 77 

Command stack, see DOS 

command stack 
Commands, one-key, 35-36 
Cut and Paste feature, 38-39, 70, 84, 86 

D 

Date function, 87 
Decimal point default, 88 
Defaults menu, 90, 162 
Delay function, 92 
Delimiter default, 94 
DES encryption, 104 
Disk wait option, 31, 96 
Display macros, 21, 44-46, 98 
auto-starting, 49 



designing help systems with, 44 

freezing keyboard with, 47 

page breaks in, 46-47 

text color and intensity, 48-49 

titles of, 49 

transparent, 48 
Distribution disks, 3, 6-7 
DOS, 191-197 

command line, used to pass 
commands, 77 

command stack, 26, 80, 82 

commands, using macros for, 15-16 

directories, and SuperKey, 9, 181, 193 

E 

Edit macros, see Macro editor 
Encryption, 24-26, 103-110 

directory, 27-28, 111 
End macro, 113 
Entry mask, in fields, 54, 114-118 



Fields, 49-55 

entry control, 54-55, 114-118 
fixed-length, 52-53, 125, 127 
formats, 53-54, 114-118, 119-122, 127 
variable-length, 50, 51-52, 175 

File encryption, 24-26 

File names, 123 

Files on SuperKey disk, 6-7, 189 

Fill character default, 124 

Fixed field, see Fields 

Format fields option, 127 
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Functions menu, 22-24, 128 
keyboard lock function, 23-24 
screen off function, 23 
time function, 22 



Graphics, and SuperKey, 41-42 

H 

Help system, 12, 44 



Installation 5, 8, 9, 183-187, 192 
and other resident programs, 8 
and tree-structured directories, 9 

K 

Keyboard buffer, 96, 131 

Keyboard click option, 132 

Keyboard layout, 59-61, 75 

Keyboard lock function, 23-24, 47, 133 

KEY.COM file, 6, 7 

KEYDES.COM file, 6, 7 

KEY. HLP file, 6 

KEYINST.COM file, 6 

Key position, changing, 59-61 

Key symbols, 134 

Keys for macros, 16 

Killing SuperKey, 9, 138 



.LAY files, 7 
Layout editor, 59-61 
LAYOUT.COM file, 6 
LETTER.TXT file, 7 
Load layout, 139 
Load macro, 19, 140 
Logged drive function, 142 
Log-on message, 9 
Lotus 1-2-3, 39 

M 

.MAC files, 7 
Macro, 13-21, 143 

autO-start, 21, 43, 49 

begin, 13 

customized, 21 

deleting, 19 

directory, 28, 144 

display, 21, 44-49 



colors, 48, 99 

transparent, 48 
editor, 55-58, 101 

editing a macro, 57 

ending the edit, 58 

main menu, 57 

status line, 55-56, 101 

using text editor, 58 

writing a macro, 56 
end, 113 
fields, 49-55 
files on disk, 189 
key symbols, 134 
loading from disk, 19, 182 
memory, 18-19, 145, 187 
merging, 47, 148 
nested, 55 
ready-made, 21 
recording, 13, 130, 154 
saving on disk, 18-19, 163 
skipping, 17, 170 
stopping, 17, 171 
suggested keys, 16 
suspending, 172 
titles, 20, 49, 169, 174 
Main menu, 11-12, 146 
Menu system, 11-12, 159 

N 

Nested macro recording, 55 

O 

One finger mode option, 30, 150 
One key commands, 35-36 
Options menu, 29-33, 151 

bottom line, 31 

disk wait, 31 

one finger mode, 30 

playback delay, 31-32 

protect delay, 32-33 

save options, 33, 164 

suspend, 30 



Path function, 153 
PCjr installation, 6-7, 8 
Playback delay option, 31-32, 155 

with spreadsheets, 41 
Protect delay option, 32-33, 157 
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R 

RAM requirements, 18-19, 145, 187 

READ-ME.COM file, 7 

Real time delay function, 161 

Reflex, 180 

Resident programs, 8, 186-187 



Save 

defaults, 162 

options, 33, 164 

macros on disk, 18-19, 163 

setup, 165 
Screen oflF function, 23, 166 
Screen protect option, 32-33, 157 
Setup menu, 27-29, 167 

encryption directory, 27-28 

macro directory, 28 

save setup, 28-29, 165 
Show titles window, 20, 169 
SideKick, 8, 58, 177 
Skip key, 17, 170 

Spreadsheets, using with SuperKey, 
39-42 

graphics, 41-42 

playback delay, 41 

1-2-3 macros, 41 
Stop, 171 
Suspend option, 30, 172 

deactivating SuperKey, 30 
System requirements, 3 



Text editor, used to create macros, 58 
Time function, 22, 173 
Titles, macro, 20, 169, 174 
Transparent display macros, 48 
Turbo Lightning, 8, 179 
Tutorial, 11-33 
Type-ahead buffer, 26 



Variable field, 50, 51-52, 175 

W 

Word processors, using with SuperKey, 
37-39 
WordStar, 38-39 



Index 



209 



210 SuperKey Owner's Manual 



Borland 
Software 




BORLAND 

INTERNATIONAL 4585 Scotts Valley Drive, Scotts Valley, CA 95066 



Available at better dealers nationwide. 

To order by credit card, call (800) S55-8008; CA (800) 742-1133; 

CANADA (800) 237-1136. 



QUATTRO 

THE PROFESSIONAL SPREADSHEET 



Borland's super graphic new genera- 
tion spreadsheet: Twice the power at 
half the price! Ten types of presen- 
tation-quality graphs. Compatible with 
l-2-3\ dBASE\ Paradox!^ and other 
spreadsheets and databases. 

Ouattro, Borland's new generation professional 
spreadsheet, proves there are better and faster 
ways to get your work done— whether it's gra- 
phics, recalculations, macros, or search and sort. 

Presentation-quality graphics 

Ouattro has excellent built-in graphics capabili- 
ties that help you create a wide variety of graphs. 
Bar graphs, line graphs, pie charts. XY graphs, 
area charts— you can create up to 10 types of 
graphs, and print them directly from the spread- 
sheet or store them for future use. 

Smarter recalculation 

When a formula needs to be recalculated. 
Ouattro uses "intelligent recalc" to recalculate 
only those formulas whose elements have changed. 
This makes Ouattro smarter and faster than other 
spreadsheets. 

Greater macro capability 

You can create macros instantly by recording 
your actions and storing them in the spreadsheet. 
The number of macros is limited only by memory. 
A built-in macro debugging environment makes it 
easy to find and correct problem areas. Ouattro 
also includes a set of over 40 macro commands 
which make up a programming language. 

Suggested retail price $195.00 
(not copyprotected) 



Direct compatibility 

Ouattro can directly load and use data files 
created with other spreadsheet and database pro- 
grams like 1-2-3, dBASE. and Paradox. Ouattro can 
read and even write WKS. WKl. and WKE files. You 
can also import ASCII and other text files into the 
spreadsheet. 

Easy installation 

Ouattro can detect most computers and screen 
types, so it's always ready to load and run! 

Plus, like all other Borland products, Ouattro is 
not copy protected! 

Ibchnical Features 

° Understands your 1-2-3 macros 

□ 100 built-in financial and statistical functions 
o Menu Builder add-in for customizing menus 
n Supports 8087/80287 math coprocessors 

□ Supports EGA. CGA. and VGA graphics adapters 
n Pop-up menus 

□ Shortcuts to menu commands 
n Context-sensitive online help 

a Three types of choice lists: (©functions and syn- 
tax, macro commands, and existing block names 

□ Pointing lets you specify a block of cells using 
arrow keys 

o Search (or Ouery) lets you find specific records 

or cells 
D Lets you arrange/rearrange data in alphabetical, 

numerical, or chronological order 
n Supports Expanded Memory Specification to 

create spreadsheets larger than 640K 
n Supports PostScript" printers and typesetters 



Minimum system requirements: For the IBM PS/2" and tlie IBM* and 
Compaq* families of persona! computers and all 100% compatibles. PC- 
DOS (MS-DOS*) 2.0 or later. Two floppies or a hard disk. 384K. 



Ouattro and Paradox are trademarks of Borland International, Inc. Lotus and 1-2-3 are regis- 
tered trademarks of Lotus Development Corp. Other brand and product names are trade- 
marks or registered trademarks of their respective holders. Copyright ei987 Borland Interna- 
tional, Inc. BOR 0414 



SMBOGX 



jHi omop 
ORBma 



Whether you're running WordStar® Lotus® dBASE® 

or any other program, SideKick puts all these desktop 

accessories at your fingertips— Instantly! 

A full-screen WordStar-like Editor to jot 

down notes and edit files up to 25 pages 
long. 



A Monthly Calendar from 1901 through 
2099. 



A Phone Directory for names, addresses, 
and telephone numbers. Finding a name or a 
number is a snap. 

An Autodialer for all your phone calls. It wil 
look up and dial telephone numbers for you. 
(A modem is required to use this function.) 



Appointment Calendar to remind you 
of important meetings and appointments. 

A full-featured Calculator ideal for 
business use. It also performs decimal 
to hexadecimal to binary conversions. 

An ASCII Table for easy reference. 





All the SideKick windows stacked up over Lotus 1-2-3.* 
From bottom to top: SideKlck's "Menu Window," ASCII 
Table, Notepad, Calculator, Appointment Calendar, Montfily 
Calendar, and Ptione Dialer. 



Here's SideKick running over Lotus 1-2-3. In tlie 
SideKick Notepad you'll notice data that's been imported 
directly trom ttie Lotus screen. In tfie upper rigtif you can 
see ttie Calculator. 



The Critics' Choice 



"In a simple, beautiful implementation of WordStar's 
block copy commands, SideKick can transport all 
or any part of the display screen (even an area 
overlaid by the notepad display) to the notepad." 
—Charles Petzold. PC MAGAZINE 

"SideKick deserves a place in every PC." 

—Gary Ray, PC WEEK 



"SideKick is by far the best we've seen. It is also 
the least expensive." 

—Ron Mansfield, ENTREPRENEUR 

"If you use a PC, gel SideKick. You'll soon become 

dependent on iL" , _ ,, _„__ 

^ —Jerry Pournelle, BYTE 



Suggested Retail Price: $84.95 (not copy protected) 

Minimum system configuration: IBM PC, XT, AT, PCjr and true compatibles. PC-DOS (MS-DOS) 2.0 or greater. 128K RAM. One disk 
drive. A Hayes-compatible modem, IBM PCjr internal modem, or AT&T Modem 4000 is required for the autodialer function. 



BORLAND 

INTERNATIONAL 



SideKick Is a registered trademark of Borland International, Inc. dBASE is a registered trademark ol 
Ashton-Tate. IBM, XT, AT, and PCjr are registered trademarks of International Business Macfiines Corp. 
AT&T is a registered trademark of American Teleptione & Telegraph Company. Lotus and 1-2-3 are 
registered trademarks of Lotus Development Corp. WordStar is a registered trademark of MicroPro 
International Corp. Hayes is a trademark of Hayes Microcomputer Products, Inc. 
Copyrigtit 1987 Borland International BOROoeoc 
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RAM-resident 
Increased productivity for IBMTCs or compatibies 

SuperKey's simple macros are electronic siiortcuts to success. 

By letting you reduce a lengthy paragraph into a single keystroke 

of your choice, SuperKey eliminates repetition. 

SuperKey turns 1,000 keystrokes into 1! 

SuperKey can record lengthy keystroke sequences and play ttiem back at the touch of a single key. 
Instantly. Like magic. 

In fact, with SuperKey's simple macros, you can tum "Dear Customer: Thank you for your inquiry. 
We are pleased to let you know that shipment will be made within 24 hours. Sincerely," into the 
one keystroke of your choice! 

SuperKey keeps your confidential files— confidential! 

Without encryption, your files are open secrets. Anyone can walk up to your PC and read your 
confidential files (tax returns, business plans, customer lists, personal letters, etc.). 

With SuperKey you can encrypt any file, even while running another program. As long as you keep 
the password secret, only you can decode your file correctly. SuperKey also implements the U.S. 
government Data Encryption Standard (DES). 



0' RAM resident— accepts new macro files 

even while running other programs 
0' Pull-down menus 
0" Superfast file encryption 
0' Choice of two encryption schemes 
0' On-line context-sensitive help 
0' One-finger mode reduces key 

commands to single keystroke 
0" Screen OFF/ON blanks out and restores 

screen to protect against "burn in" 
Partial or complete reorganization of 

keyboard 



0" Keyboard buffer increases 16 character 

keyboard "type-ahead" buffer to 128 

characters 
0' Real-time delay causes macro playback 

to pause for specified interval 
Transparent display macros allow 

creation of menus on top of application 

programs 
Data entry and format control using 

"fixed" or "variable" fields 
Command stack recalls last 256 

characters entered 



Suggested Retail Price: $99.95 (not copy protected) 



Minimum system configuration: IBM PC, XT, AT, PCjr, and true compatibles. PC-DOS (MS-DOS) 
2.0 or greater. 128K RAM. One disk drive. 



BORLAND 

INTERNA T I N A L 



SuperKey is a registered trademarl( of Borland International, Inc. IBM, XT, AT, and PCjr are 
registered trademarks of International Business Mactiines Corp. MS-DOS is a registered 
trademark of Microsoft Corp. bor ooezc 



If you use an IBM® PC, you need 



U 



Lightning 



Turbo Lightning teams up 
with the Random House 
Concise Word List to 
check your spelling as 
you type! 

Turbo Lightning, using the 
80,000-word Random House 
Dictionary, checks your spelling 
as you type. II you misspell a 
word, it alerts you with a 
"beep." At the touch of a key. 
Turbo Lightning opens a 
window on top of your 
application program and 
suggests the correct spelling. 
Just press one key and the 
misspelled word is instantly 
replaced with the correct word. 

Turbo Lightning works 
hand-in-hand with the 
Random House Thesaurus 
to give you instant access 
to synonyms 

Turbo Lightning lets you 
choose just the right word from 
a list of alternates, so you 
don't say the same thing the 
same way every time. Once 
Turbo Lightning opens the 
Thesaurus window, you see a 
list of alternate words; select 
the word you want, press 
ENTER and your new word will 
/instantly replace the original 
word. Pure magic! 



If you ever write a 
word, think a word, or 
say a word, you need 
Turbo Lightning 
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The Turbo Lightning Proofreader 




The Turbo Lightning Thesaurus 



You can teach Turbo 
Lightning new words 

You can teach your new Turbo 
Lightning your name, business 
associates' names, street 
names, addresses, correct 
capitalizations, and any 
specialized words you use 
frequently. Teach Turbo 
Lightning once, and it 
knows forever. 

Turbo Lightning is the 
engine that powers 
Borland's Turbo Lightning 
Library"^ 

Turbo Lightning brings 
electronic power to the 
Random House Concise Word 
List and Random House 
Thesaurus. They're at your 
fingertips— even while you're 
running otfier programs. Turbo 
Lightning will also "drive" 
soon-to-be-released 
encyclopedias, extended 
thesauruses, specialized 
dictionaries, and many other 
popular reference works. You 
get a head start with this 
first volume in the Turbo 
Lightning Library. 



Suggested Retail Price: $99.95 (not copy protected) 



Minimum system configuration: IBM PC, XT, AT, PCjr, and true compatibles with 2 (loppy disk drives. PC-DOS (MS-DOS) 2.0 or greater. 
256K RAM. Hard disk recommended. 



BORLAND 

INTERNATIONAL 



Turbo Lightning and Turbo Lightning Library are registered trademarlis of Borland International, Inc. 
IBM, XT AT, and PCjr are registered tradennarks ol International Business Machines Corp, Random 
House is a registered trademark ol Random House, Inc. Copyright 1987 Borland International 

BOR 0070B 



Your Development Toolbox and Technical Reference Manual for Tbrbo Lightning® 



LIGHTNING 




najoD 



Lightning Word Wizard includes complete, commented Turbo 

Pascal® source code and all the technical inlormation you'll 

need to understand and work with Turbo Lightning's "engine." 

More than 20 fully documented Turbo Pascal procedures 

reveal powerful Turbo Lightning engine calls. Harness the full power 

of the complete and authoritative Random House® Concise 

Word List and Random House Thesaurus. 



Turbo Lightning's "Reference 
Manual" 

Developers can use the versatile on-line 
examples to harness Turbo Lightning's 
power to do rapid word searches. Lightning 
Word Wizard is the forerunner of the data- 
base access systems that will incorporate 
and engineer the Turbo Lightning Library® 
of electronic reference works. 



Tiie ultimate collection of word 
games and crossword solvers! 

The excitement, challenge, competition, 
and education of four games and three 
solver utilities— puzzles, scrambles, spell- 
searches, synonym-seekings, hidden words, 
crossword solutions, and more. You and 
your friends (up to four people total) can 
set the difficulty level and contest the high- 
speed smarts of Lightning Word Wizard! 



Turbo Lightning— Critics' Choice 

"Lightning's good enough to make programmers and users cheer, executives of other 
software companies weep." Jim Seymour, PC Week 

"The real future of Lightning clearly lies not with the spelling checker and thesaurus currently 
included, but with other uses of its powerful look-up engine." Ted Sllveira, Profiles 



"This newest product from Borland has it all." 



Don Roy, Computing Now! 



Minimum system configuration: IBM PC, XT, AT, PCjr, Portable, and true compatibles. 256K RAM minimum. PC-DOS (MS-DOS) 2.0 
or greater. Turbo Lightning software required. Optional— Turbo Pascal 3.0 or greater to edit and compile Turbo Pascal source code. 



BORLAND 

INTERNATIONAL 



Suggested Retail Price: $69.95 
(not copy protected) 



Turbo Pascal, Turbo Lightning and Turbo Lpning Library are registered Irademarlcs and Ligiitning Word Wizard is a trademark of Borland InternationaL Inc. Random 
House is a registered trademark ol Random House, Inc. IBM, XT, AT, and PCjr are registered trademarks ol International Business Machines Corp. MS-DOS is a 
registered trademark of Microsoft Corp. Copyright 1987 Borland International boroo87b 
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The high-performance database manager 
that's so advanced it's easy to use! 

Lets you organize, analyze and report information faster tlian ever before! If you manage mailing lists, 
customer files, or even your company's budgets— Reflex is the database manager for you! 

Reflex is the acclaimed, high-performance database manager you've been vi/aiting for. Reflex extends 
database management v/ith business graphics. Because a picture is often worth a 1000 words. Reflex 
lets you extract critical information buried in mountains of data. With Reflex, when you look, you see. 

The REPORT VIEW allows you to generate everything from mailing labels to sophisticated reports. 
You can use database files created with Reflex or transferred from Lotus 1-2-3,* dBASE,* PFS: File,* 
and other applications. 




Reflex: The Critics' Choice 

". . . if you use a PC, you should know about Reflex ... may be the best bargain in software today." 

Jerry Pournelle, BYTE 
"Everyone agrees that Reflex is the best-looking database they've ever seen." 

Adam B. Green, InfoWorld 

"The next generation of software has officially arrived." Peter Norton, PC Week 

Reflex: don't use your PC without it! 

Join hundreds of thousands of enthusiastic Reflex users and experience the power and ease of use of 
Borland's award-winning Reflex. 

Suggested Retail Price: $149.95 (not copyprotected) 

Minimum system configuration: IBM PC, XT, AT, and true compatibles. 384K RAM minimum. IBM Color Graphics Adapter, Hercules 
Monochrome Graphics CArd, or equivalent. PC-DOS (MS-DOS) 2.0 or greater. Hard disk and mouse optional. Lotus 1-2-3, dBASE, 
or PFS: File optional. 



BORLAND 

INTERNATIONAL 



Reflex is a tradernark of Borland/Analytica Inc. Lotus 1-2-3 is a registered trademarl( of Lotus 
Development Corporation. dBASE is a registered trademaric of Asfiton-Tate. PFS: File is a 
registered tradennark of Software Publistilng Corporation. IBM, XT, AT, and IBM Color Graptiics 
Adapter are registered trademarks of International Business Mactiines Corporation. Hercules 
Graptiics Card is a trademark of Hercules Computer Technology. MS-DOS is a registered 
trademark of Microsoft Corp, Copyright 1987 Borland International bor ooeec 
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:m WORKSHOP 

Includes 22 "Instant templates" covering a broad range of 

business applications (listed below). Also shows you how to 

customize databases, graphs, crosstabs, and reports. It's an Invaluable 

analytical tool and an Important addition to another one of 

our best sellers, Reflex: The Database Manager. 

Fast-start tutorial examples: 

Learn Reflex® as you work with practical business applications. The Reflex Workshop Disk supplies 
databases and reports large enough to illustrate the power and variety of Reflex features. Instructions in each 
Reflex Workshop chapter take you through a step-by-step analysis of sample data. You then follow simple 
steps to adapt the files to your own needs. 

22 practical business applications: 

Workshop's 22 "instant templates" give you a wide range of analytical tools: 



Administration 

• Scheduling Appointments 

• Planning Conference Facilities 

• Managing a Project 

• Creating a Mailing System 

• Managing Employment Applications 

Sales and Marlceting 

• Researching Store Check Inventory 

• Tracking Sales Leads 

• Summarizing Sales Trends 

• Analyzing Trends 

Production and Operations 

• Summarizing Repair Turnaround 



• Tracking Manufacturing Quality Assurance 

• Analyzing Product Costs 

Accounting and Financial Pianning 

• Tracking Petty Cash 

• Entering Purchase Orders 

• Organizing Outgoing Purchase Orders 

• Analyzing Accounts Receivable 

• Maintaining Letters of Credit 

• Reporting Business Expenses 

• Managing Debits and Credits 

• Examining Leased Inventory Trends 

• Tracking Fixed Assets 

• Planning Commercial Real Estate Investment 



Whether you're a newcomer learning Reflex basics or an experienced "power user" looking for tips, Reflex: 
The Workshop will help you quickly become an expert database analyst. 

Minimum system configuration: IBM PC, AT, and XT, and true compatibies. PC-DOS (MS-DOS) 2.0 or greater. 384K RAM minimum. Requires Reflex: 
The Database Manager, and IBM Color Graphics Adapter, Hercules Monochrome Graphics Card or equivalent. 




BORLAND 

INTERNA T I N A L 



Suggested Retail Price: $69.95 
(not copy protected) 



Reflex is a registered trademark and Reflex: Tfie Workstiop is a trademark of Borland/Analytica, Inc. IBM, AT, and XT are registered trademarks of International Business 
Mactiines Corp. Hercules is a trademark of Hercules Computer Tectinology. MS-DOS is a registered trademark of Microsoft Corp. Copyright 1987 Borland International 

BOR 0088B 
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Tlirbo Pascal 4.0 has all the features 

"Rirbo Pascal 4.0 has all the features ofRirbo 
Pascal 3.0, plus an amazing compilation speed of 
27,000 lines per minute,* support for programs 
larger than 64 K, a library of powerful standard 
units, separate compilation, and much more. 

The single-pass, native code compiler offers 
improved code generation, smart linkihg to remove 
unused code from your programs, built-in project 
management, separate compilation using units, out- 
put screen saved in a window, MAP files for use 
with standard debuggers, a command-line version 
of the compiler and MAKE utility, and built-in sup- 
port for 8087/80287/80387 math coprocessors. 

All these advanced features, plus the integrated 
programming environment, online help, and 
Borland's famous pull-down menus, make Tlirbo 
Pascal 4.0 the high-speed, high-performance devel- 
opment tool every programmer hopes for. 

Built-in editor 

An improved, full-screen editor for editing, compil- 
ing, and finding and correcting errors from inside 
the integrated development environment. Supports 
25, 43. and 50 lines per screen, tabs, colors, and 
new command installation. 

Interactive error detection 

The compiler instantly locates errors, automatically 
activates the editor, and shows you the location of 
the error in the source code. 

Pick list 

Lets you pick a file from a list of the last eight files 
loaded into the editor and opens it at the exact spot 
where you last edited the file. It even remembers 
your last search string and search options. 



Free MicroCalc spreadsheet 

A new and improved version of the full-fledged 
spreadsheet included on your TVirbo Pascal disk, 
absolutely free! You get the complete, revised 
source code, ready to compile and run. 

Compatibility with Thrbo Pascal 3.0 

A conversion program and compatibility units help 
you convert all your 3.0 programs to 4.0. 

Other Technical Features: 

o Several powerful standard units {System Dos, 

Cn, and Graph) 
n Device-independent graphics support for CGA. 

MGGA, EGA. VGA. Hercules. AT&T 6300. and 

IBM 3270 PC 
n Extended data types, including Longint 
o Optional range- and stack-checking; short-circuit 

Boolean expression evaluation 
D Support for inline statements, inline macros, and 

powerful assembly language interface 
n Faster software-only floating point; toggle switch 

for 80x87 support including Single, Double. 

Extended, and Comp IEEE reals (with numeric 

coprocessor) 
□ Automatic execution of initialization and exit 

code for each unit 
n Nested include files up to 8 levels deep, includ- 
ing main module and units 
n Operating system calls and interrupts 
p Interrupt procedure support for ISRs 
p Variable and value typecasting 
p Shell to DOS transfer 



Minimum system requirements: For the IBM PS/2' and the IBM* and 
Compaq* families of personal computers and all 100% compatibles, inte- 
grated environment: 384K: command line: 256K: one floppy drive. 
*Run on an 8MHz IBM AT 



Suggested retail price $99.95 
(not copyprotected) 

All Borland products are trademarks or registered trademarks of Borland International, Inc. 
Other brand and product names are trademarks or registered trademarks of tfieir respective 
fielders. Copyrigfit ei987 Borland International, Inc. BOR 0506 
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An unsurpassed collection of TURBO 
PASCAL TOOLS that make you the 
expert, now upgraded to Version 4.0! 

Thrbo Pascal Thtor: 

For both the novice programmer and the profes- 
sional. Everything you need to write a simple pro- 
gram or handle advanced concepts like using 
assembly language routines with your Tlirbo Pascal 
programs. The programmer's guide covers the fine 
points of Tlirbo Pascal programming with lots of 
examples; and on accompanying disk gives you all 
the source code. A real education for just $69,951 

Tlirbo Pascal Editor Toolbox: 

Everything you need to build your own custom 
text editor or word processor including easy-to- 
install modules, source code and plenty of know- 
how. Includes all the popular features like word- 
wrap, auto indent, find/replace. Just $99,951 

Tlirbo Pascal Database Toolbox: 

A complete library of Pascal procedures that let 
you sort and search your data and build powerful 
applications. Includes Tlirbo Access files that use 
B-i- trees to organize and search your data, and 
Rirbo Sort to sort it. GINST even gets your pro- 
grams up and running on other terminals! Includes 
a free database that you can use as is or modify to 
suit your needs. Just $99.95\ 

Turbo Pascal Graphix Toolbox: 

Gives you all the high-resolution graphics and 
graphic window management capabilities you need, 
with tools to draw and hatch pie charts, bar charts, 
circles, rectangles and a full range of geometric 
shapes. Save and restore graphic images to and 
from disk, plot precise curves, and create anima- 
tion.* All for just $99,951 



Tlirbo Pascal GameWorks: 

Secrets and strategies of the masters with easy- 
to-understand examples that teach you how to 
quickly create your own computer games using 
Tlirbo Pascal. For instant excitement, play the three 
great computer games included on disk— Tlirbo 
Chess. Tlirbo Bridge and Tlirbo Go-Moku. They're 
all compiled and ready to run. Just $99,951 

Tlirbo Pascal Numerical 
Methods Toolbox: 

All the state-of-the-art applied mathematical 
tools you'll ever need. A collection of Tlirbo Pascal 
mathematical routines and programs and ten inde- 
pendent modules that you can easily adapt to dif- 
ferent programs. Gives you the kind of mathemati- 
cal routines IMSL® and NAG libraries provide for 
FORTRAN. Complete with sample programs and 
source code for each module. All for just $99,951 

Buy them separately or get The 
Developer's Library, which includes 
all six, for just $395 suggested retail 
price! Not copy protected! 



System Requirements: For the IBM PS/2" and the IBM* and Compaq* 
families of personal computers and ail 100% compatibles. 
Operating System: PC-DOS (MS-DOS) 2.0 or later. 
*71;r/)o Pascal Graphix Tbolbox also requires one of the following 
graphics adapters: CGA, EGA. Hercules, or IBM 3270. 

All Borland products are trademarks or registered trademarks of Borland International, Inc. 
Borland Turbo Toolbox* products. Other brand and product name are trademarks or regis- 
tered trademarks of ttieir respective fielders. Copyrigfit ©1987 Borland International, Inc. 

BOR 0486 
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the natural language of Artificial Inteigence 

Turbo Prolog brings fiftb-generation supercomputer 
power to your iBM^PC! 






Turbo Prolog takes 
programming Into a new, 
natural, and logical 
environment 

With Turbo Prolog , 
because of its natural, 
logical approacti, botti 
people new to programming 
a^cf professional programmers 
can build powerful applica- 
tions such as expert systems, 
customized knowledge 
bases, natural language 
interfaces, and smart 
information management systems. 

Turbo Prolog is a declarative language 
which uses deductive reasoning to solve 
programming problems. 




Turbo Prolog's development system 
includes: 

D A complete Prolog compiler that is a variation ol the 
Clocksin and Melllsh Edinburgh standard Prolog. 

D A full-screen interactive editor. 

D Support for both, graphic and text windows. 

n All the tools that let you build your own 
expert systems and Al applications with 
unprecedented ease. 



Turbo Prolog provides 
a fully integrated pro- 
gramming environment 
like Borland's Turbo 
Pascal,® the de facto 
worldwide standard. 

You get the complete 
Turbo Prolog program- 
ming system 

You get the 200-page 
manual you're holding, 
software that includes 
the lightning-fast Turbo 
Prolog six-pass 
compiler and interactive editor, and the 
free GeoBase natural query language 
database, which includes commented 
source code on disk, ready to compile. 
(GeoBase is a complete database 
designed and developed around U.S. 
geography. You can modify it or use 
it "as is.") 

Minimum system configuration: IBM PC, XT, AT, 
Portable, 3270, PCjr, and true compatibles. PC-DOS 
(MS-DOS) 2.0 or later. 384K RAM minimum. 



Suggested Retail Price $99.95 
(not copy protected) 




BORLAND 

INTERNATIONAL 



Turbo Prolog Is a trademark and Turbo Pascal is a registered trademark of 
Borland International, Inc. IBM AT, XT, and PCjr are registered trademarks of 
International Business Machines Corp. MS-OOS is a registered 
trademark of Microsoft Corp. 
Copyright 1987 Borland International BOR 0016D 




Enhances Turbo Prolog with more than 80 tools 
and over 8,000 lines of source code 

Turbo Prolog, the natural language of Artificial Intelligence, Is the 

most popular Al package in the world with more than 100,000 users. 

Our new Turbo Prolog Toolbox extends Its possibilities. 

The Turbo Prolog Toolbox enhances Turbo Prolog— our 5th-generation computer programming 
language that brings supercomputer power to your IBM PC and compatibles— with its more than 80 
tools and over 8,000 lines of source code that can be incorporated into your programs, quite easily. 



Turbo Prolog Toolbox features include: 

S' Business graphics generation: boxes, circles, ellipses, bar charts, pie charts, scaled graphics 

Hf Complete communications package: supports XModem protocol 

& File transfers from Reflex," dBASE III,* Lotus 1-2-3,* Symphony 

0" A unique parser generator: construct your own compiler or query language 

S' Sophisticated user-interface design tools 

[vf 40 example programs 

E" Easy-to-use screen editor: design your screen layout and I/O 

^ Calculated fields definition 

& Over 8,000 lines of source code you can incorporate into your own programs 



Suggested Retail Price: $99.95 (not copy protected) 



Minimum system configuration: IBM PC, XT, AT or true compatibles. PC-DOS (MS-DOS) 2.0 or later. Requires Turbo Prolog 1.10 
or higher. Dual-floppy disk drive or hard disk. 51 2K. 



Turbo Prolog Toolbox and Turbo Prolog are trademarks o( Borland International, Inc. Rellex 

Is a registered trademark of Borland/Analytica, Inc. dBASE III is a registered trademark of 

Astiton-Tate. Lotus 1-2-3 and Symphony are registered trademarks ol Lotus Development 

Corp. IBM, XT and AT are registered trademarks of International Business Mactiines Corp. 

INTERNATIONAL MS-DOS is a registered trademark ol Microsoft Corp. BOR 0240 
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The high-speed BASIC you've been waiting for! 

You probably know us for our Turbo Pascal*^ and Turbo Prolog.'' Well, we've done 
it again! We've created Turbo Basic, because BASIC doesn't have to be slow. 

If BASIC taught you how to walk, Turbo Basic will teach you how to run! 

With Turbo Basic, your only speed is "Full Speed Ahead"! Turbo Basic is a complete development envir- 
onment with an amazingly fast compiler, an interactive editor and a trace debugging system. And because 
Turbo Basic is also compatible with BASICA, chances are that you already know how to use Turbo Basic. 

Turbo Basic ends the basic confusion 

There's now one standard: Turbo Basic. And because Turbo Basic is a Borland product, the price is right, 
the quality is there, and the power is at your fingertips. Turbo Basic is part of the fast-growing Borland 
family of programming languages we call the "Turbo Family." And hundreds of thousands of users are 
already using Borland's languages. So, welcome to a whole new generation of smart PC users! 

Free spreadsheet included with source code! 

Yes, we've included MicroCalc," our sample spreadsheet, complete with source code. So you can get 
started right away with a "real program." You can compile and run it "as is," or modify it. 



A technical look at Turbo Basic 


a' Full recursion supported 


executable program, with separate windows 


Q' Standard IEEE floating-point format 


for editing, messages, tracing, and execution 


a' Floating-point support, with full 8087 copro- 


S' Compile and run-time errors place you in 


cessor integration. Software emulation if no 


source code where error occurred 


8087 present 


S' Access to local, static and global variables 


0' Program size limited only by available 


0' New long integer (32-bit) data type 


memory (no 64K limitation) 


0' Full 80-bit precision 


[^ EGA, CGA, MCGA and VGA support 


a' Pull-down menus 


0' Full integration of the compiler, editor, and 


0' Full window management 



Suggested Retail Price: $99.95 (not copy protected) 

Minimum system configuration: IBM PC, at, XT PS/2 or true compatibles. 320K. One floppy drive. PC-DOS (MS-DOS) 2.0 or later. 



BORLAND 

INTERNATIONAL 



lirbo Basic, Turbo Prolog and Turbo Pascal are registered trademarks and MicroCalc is a trade- 
mark ol Borland International, Inc. Other brand and product names are trademarks or registered 
trademarks of their respective holders. 
Copyrigtit 1987 Borland International BOR 0265B 
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With the Turbo Basic Database Toolbox you can build your own 

powerful, professional-quality database programs. And like all other 

Borland Toolboxes, it's advanced enough for professional 

programmers yet easy enough for beginners. 



Three ready-to-use modules 

The Toolbox enhances your program- 
ming with three problem-solving 
modules: 

Turbo Access quickly locates, inserts, 
or deletes records in a database using 
B+ trees— the fastest method for finding 
and retrieving database information. 
(Source code is included.) 

Turbo Sort uses the Quicksort 
method to sort data on single items 
or on multiple keys. Features virtual 
memory management for sorting large 
data files. (Commented source code 
is on disk.) 

TRAINER is a demonstration program 
that graphically displays how B+ trees 
work. You can key in sample records and 
see a visual index of B+ trees being 
built. 



Free sample database 

Included is a free sample database 
with source code. Just compile it, and it's 
ready to go to work for you— you can 
use it as is or customize it. You can 
search the database by keywords or 
numbers, update records, or add and 
delete them, as needed. 

Saves you time and money 

If you're a professional programmer 
writing software for databases or other 
applications where search-and-sort capa- 
bilities are important, we can save you 
time and money. Instead of writing the 
same tedious but essential routines over 
and over again, you can simply include 
any of the Toolbox's modules 
in your own compiled programs. 



Maximum number of files open: 

or 7 data sets 
Maximum file size: 32 Mb 
Maximum record size: 32K 


Technical Features 

15 files, Maximum number of records: -1-2 billion 
Maximum field size: 32K 
& Maximum key size: 128 bytes 
& Maximum number of keys: +2 billion 



Suggested Retail Price: $99.95 (not copy protected) 

Minimum system requirements: For the IBM PS/2 and the IBM' and Compaq* families of personal computers and all 100% compatibles, running 
Turbo Basic 1.0. PC-DOS (MS-DOS') 2.0 or later. Memory. 640K. 




BORLAND 

INTERNATIONAL 



All Borland products are registered trademarks or trademarks of Borland 
International, Inc. or Borland/Analytica, Inc. A Borland Turbo Toolbox pro- 
duct. Other brand and product names are trademarks or registered trade- 
marks ol tfieir respective fiolders. Copyright 1987 Borland International. 

BOR 0384A 
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A complete interactive development environment 

With Turbo C, you can expect what only Borland delivers: 

Quality, Speed, Power and Price. And with its compilation 

speed ol more than 7000 lines a minute, Turbo C makes 

everything else look like an exercise in slow motion. 

Turbo C: The C compiler for both amateurs and professionals 

If you're just beginning and you've "kinda wanted to learn C," now's your cliance to do it ttie easy way. 
Turbo C's got everyttiing to get you going. If you're already programming in C, switctiing to Turbo C wil 
considerably increase your productivity and tielp make your programs both smaller and faster. 

Turbo C: a complete Interactive development environment 

Like Turbo Pascal* and Turbo Prolog," Turbo C comes with an interactive editor that will show 
you syntax errors right in your source code. Developing, debugging, and running a Turbo C 
program is a snap! 



Technical 

H^ Compiler: One-pass compiler generating native in- 
line code, linkable object modules and assembler. 
The object module formal is compatible with the 
PC-DOS linker. Supports small, medium, compact, 
large, and huge memory model libraries. Can mix 
models with near and far pointers. Includes 
floating point emulator (utilizes 8087/80287 if 
installed). 

H^ Interactive Editor: The system includes a powerful, 
interactive full-screen text editor. If the compiler 
delects an error, the editor automatically positions 
the cursor appropriately in the source code. 



Specifications 

^ Development Environment A powerful "Make" is 
included so that managing Turbo C program 
development is easy. Borland's fast "Turbo 
Linker" is also included. Also includes pull-down 
menus and windows. Can run from the environ- 
menl or generate an executable file. 

13^ Links with relocatable object modules created 
using Borland's Turbo Prolog into a 
single program. 

W ANSI C compatible. 

H\ Start-up routine source code included. 

[m Both command line and integrated environment 
versions included. 



"Sieve" benchmark (25 ileratioas) 





Turbo C 


Micmsoft' C 


Lattice C 


Compile time 


3.89 


16.37 


13.90 


Compile and link time 


9.94 


29.06 


27.79 


Execution time 


5.77 


9.51 


13.79 


Object code size 


274 


297 


301 


Price 


$99.95 


$450.00 


$500.00 



Benchmark run on a 6 Mhz IBM AT using Turbo C version 1.0 and tlie Turbo Linl<er version 1.0; Microsoft C version 4.0 and the 
MS overlay linker version 3.51; Lattice C version 3.1 and the MS object linker version 3.05. 

Suggested Retail Price: $99.95* (not copy protected) introductory otter good through juiy 1. 1937 

Minimum system configuration: IBM PC, XT, AT and true compatibles. PC-DOS (MS-DOS) 2.0 or later. One floppy drive. 320K. 



BORLAND 

INTERNATIONAL 



Turbo C and Turtx) Pascal are registered trademarks and Turbo Prolog is a tradeniark of Borland 
International, Inc. Microsoft C and MS-OOS ae registered traderrBrks ol Microsoft Corp. lattice C 
is a registered trademark of Lattice, Inc. IBM, XT, and AT are registered trademarks of International 
Business Mactiines Corp. bor 0243 
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The solution to your most complex 
equations— In seconds! 

If you're a scientist, engineer, financial analyst, student, teacher, or any other professional working with 
equations. Eureka: The Solver can do your Algebra, Trigonometry and Calculus problems in a snap. 

Eureka also handles maximization and minimization problems, plots functions, generates reports, and 
saves an incredible amount of time. Even if you're not a computer specialist. Eureka can help you 
solve your real-world mathematical problems fast, without having to learn numerical approximation 
techniques. Using Borland's famous pull-down menu design and context-sensitive help screens. Eureka 
is easy to learn and easy to use— as simple as a hand-held calculator. 

X + exp(X) = 10 solved instantly Instead of eventually! 

Imagine you have to "solve for X," where X + exp(X) = 10, and you don't have Eureka: The Solver. 
What you do have is a problem, because it's going to take a lot of time guessing at "X." With Eureka, 
there's no guessing, no dancing in the dark— you get the right answer, right now. (PS: X = 2.0705799, 
and Eureka solved that one in .4 of a second!) 



How to use Eureka: The Solver 



It's easy. 



You can then tell Eureka to 



1. Enter your equation into the 




■ Evaluate vour solution 


full-screen editor ■ piot a graph 


2. Select the "Solve" command ■ Generate a report, then send the output 


3. Look at the answer to your printer, disk file or screen 


4. You're done 




■ Or all of the above 


Some of Eureka's key features 




Eureka: The Solver includes 


You can key in: 




[Vf A full-screen editor 


[Ef A formula or formulas 




[vf Pull-down menus 


2[ A series of equations— and solve for 




[Vf Context-sensitive Help 


all variables 




[Vf On-screen calculator 


(vf Constraints (like X has to be 




[Vf Automatic 8087 math co-processor 


< or = 2) 




chip support 


Ef A function to plot 




[vf Powerful financial functions 


[Ef Unit conversions 




[Vf Built-in and user-defined math and 


gf Maximization and minimization problems 




financial functions 


[Vf Interest Rate/Present Value calculations 




[Vf Ability to generate reports complete with 


(Vf Variables we call "What happens?," like 




plots and lists 


"What happens if 1 change this variable to 




[Vf Polynomial finder 


21 and that variable to 27?" 




[vf Inequality solutions 



Minimum system configuration: IBM PC, AT XT PS/2, Portable, 
3270 and true compatibles. PC-DOS (MS-DOS) 2.0 and 
later. 384K. 



Suggested Retail Price: $167.00 
(not copy protected) 



BORLAND 

INTERNATIONAL 



Eureka: Ttie Solver is a trademark of Borland International, Inc. IBM, AT and XT are registered 
trademarks of International Business Machines Corp. MS-DOS Is a registered trademark of 
Microsoft Corp. Copyright 1987 Borland International BOR 0221 B 
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Macintosh" 

The most complete and comprehensive collection of 
desk accessories available for your Macintosh! 

Thousands of users already know that SideKick is the best collection of desk accessories available 
for the Macintosh. With our new Release 2.0, the best just got better. 

We've just added two powerful high-performance tools to SideKick— Outlook": The Outliner 
and IVIacPlan": The Spreadsheet. They work in perfect harmony with each other and while you 
run other programs! 

Outlook: The Outliner 

■ It's the desk accessory with more power than a stand-alone outliner 

■ A great desktop publishing tool, Outlook lets you incorporate both text and graphics 
into your outlines 

■ Works hand-in-hand with IVIacPlan 

■ Allows you to work on several outlines at the same time 

MacPlan: The Spreadsheet 

■ Integrates spreadsheets and graphs 

■ Does both formulas and straight numbers 

■ Graph types include bar charts, stacked bar charts, pie charts and line graphs 

■ Includes 12 example templates free! 

■ Pastes graphics and data right into Outlook creating professional memos and reports, complete 
with headers and footers. 



SideKick: The Desktop Organizer, 
Release 2.0 now includes 

2l Outlook: The Outliner 
El MacPlan: The Spreadsheet 
gl Mini word processor 
Ei Calendar 
g] PhoneLog 
gl Analog clock 
Ej Alarm system 
2l Calculator 
g] Report generator 

EJ Telecommunications (new version now 
supports XModem file transfer protocol) 



* File Edit Uieui Special Worksheet 



1 : INCOME FpREC AST: 



MocPlan 6rapti 




■ 13.671S SiVl k 
D tS94« SateiB 
B 29.61 « ToUIRvv 



Ea 



09 



■ 0% ExptniM 

□ a.l^% Uhor 

O 4.669 Matff-ub 

S 67^% Ovrr1i.«d 

D 11.1B1E Tol^E: 

B 18.43K Nft Proril 



$21962; 
$292 82:* 
■$527.0'3:' 



$790,37: $1,059 84: 




MacPlan does both spreadsheets and business 

graphs. Paste them into your Outlook files and 

generate professional reports. 



Suggested Retail Price: $99.95 (not copy protected) 

Minimum system configurations: Macintosh 51 2K or Macintosh Plus with one disk drive. One 800K or two 400K drives are recommended. 
With one 400K drive, a limited number of desk accessories will be installable per disk. 



BORLAND 

INTERNATIONAL 



SideKick is a registered trademark and Outtook and MacPlan are trademarks of Borland 
International, Inc. Macintosh is a trademark ol Mcintosh Laboratory, Inc. licensed to Apple 
Computer, Inc. Copyright 1987 Borland International bor oo69D 
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All the Power & Flexibility of a Relational Database Made Easy! 
Reflex Plus: The Database Manager is the first relational database that's 

easy to learn, powerful, and aimed at yourneeds. Reflex Plus is 
not a mere file organizer, nor is it a monstrously complicated behemoth 
aimed solely at consultants. Reflex Plus is the only relational database 
aimed at your needs and time constraints. 



Reflex Plus accomplishes this by taking full advantage of the 
Macintosh's superior graphic ability while still giving users what 
they want: unlimited flexibility in creating databases, accessing 
data, and producing reports. 

What puts the plus into Reflex Plus? 

Borland listens to its customers and has added the most- 
asked-for features and improvements to Reflex Plus. 

High-powered features of Reflex Plus: 

H' IVIultiple entry forms for the same database. 

H' Entry for more than one database in a single entry form. 

S' Your choice of having an entry form that shows one record 

at a time, or one that shows all the records at once. 
H' Calculated fields in entry forms. 
H' Display-only fields. 
H' Default (but editable) fields. 
H' New functions like GROUPBY, which lets you easily show 

records grouped by values in common. 
H' A selection of useful templates. 
B' Larger record size. (You can now choose record sizes of 

1000, 2000, or 4000 characters.) 

Cfieck out these Reflex Plus features: 

H' Visual database design. 

(3' A "what you see is what you get" design capability both 

for entry forms and reports. 
H" Compatible with all Macintoshes with at least 51 2K, 

including the SE", and Macintosh 11." 

The heart of Reflex Plus is in its special functions with 
which you create formulas. With over 50 function words to 
choose from, you are given all the power of programming with- 
out struggling with complex syntax. Reflex Plus functions are 
straightforward and can handle all types of data. 



Armed with these functions, you create formulas that 
sort, search, calculate, quantify, qualify— you name it. And if 
you don't feel up to writing the formula yourself, Reflex Plus 
will do it for you. Using the FormulaBuild dialog box, you can 
master even the most complicated formula. 

Display grouped data. Reflex Plus gives you unlimited 
flexibility when you want to display your data grouped in mean- 
ingful ways. 

Flexible entry forms. Most databases have a data entry 
form, and that's that. Reflex Plus lets you design your own (but 
if you don't want to bother. Reflex Plus will make one for you). 
Here are just some of the options available in your entry forms: 

H' View all records at once. 

Q' View one record at a time. 

H' Enter data into many databases at once. 

H' Use calculated fields. 

B' Default values in fields, display-only values, and lots more. 

Convenience and Ease 

Sf Preset entry forms. Let Reflex Plus create an entry 
form for you. 

H' Preset reports. Let Reflex Plus create a table-style 
report for you. 

B' Paste Formula command. Let Reflex Plus guide you 
through the steps of creating formulas for power searching 
and data manipulation. 

B' On-line help facility. Reflex Pius has an extensive on- 
screen, context-sensitive help feature. 

B' Paste Choice command. This compiand lets you paste 
in fields that duplicate all the attributes of another field. A 
great time saver. Thecommand als(5 lets you build formu- 
las by pointing and clicking. 

B' Auto-save. You'll never lose data again with Reflex 
Plus's auto-save feature. 



Database specifications: Maximum single field length: 4072 bytes. Maximum fields per record: 254. Maximum record length: 4080 bytes. 
Maximum records per file: limited only by disk capacity. Maximum number of linked database files: 200. Maximum number of open windows: 
15. Maximum number of files that can be used by a report: no limit. 

Suggested Retail Price: $279.00 (not copyprotected) 

Minimum system requirements: Runs on any Macintosh with at least 512K memory. Minimum setup is one 800K (double-sided) disk drive or two 400K (single-sided) 
drives Works with the Hierarchical File System, Switcher, and most hard disks. Supports printing on the ImageWriter and the LaserWriter. 



Reflex is a registered trademark of BorlandMnalytica, Inc. Other brand and pro- 
duct names are trademarks or registered trademarks of their respective 
holders. Copyright 1987 Borland Inlernational BOR 0149a 
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Borland's Macintosh version of Turbo 
Pascal is so incredibly fast that it can 
compile 1,420 lines of source code in 
the 7. 1 seconds it took you to read this! 

And reading the rest of this takes about 5 minutes, 
which is plenty of time for Tlirbo Pascal to compile at 
least 60.000 more lines of source code! 

Tlirbo Pascal does both Windows and 
Units 

The separate compilation of routines offered by 
Tlirbo Pascal creates modules called Units, which can 
be linked to any Tlirbo Pascal program. This modular 
pathway gives you pieces that can be integrated into 
larger programs. You can use memory more efficiently 
and reduce the time it takes to develcp large 
programs. 

Tlirbo Pascal is so compatible with 
MPWthat they should be living 
together 

You can compile and run routines from Macintosh 
Programmer's Workshcp Pascal and Inside Macintosh 
with only the subtlest changes. Tlirbo Pascal is also 
compatible with the Hierarchical File System of the 
Macintosh. 



The 27-second Guide to Tlirbo Pascal 

o Compilation speed of more than 12,000 lines 

per minute 
D Unit structure lets you create programs in 

modular form 

□ Multiple editing windows— up to 8 at a time 

□ Compilation options include compiling to disk or 
memory, or compile and run 

□ No need to switch between programs to compile 
or run a program 

□ Streamlined develcpment and debugging 

□ Compatibility with Macintosh Programmer's Work- 
shop Pascal (with minimal changes) 

D Compatibility with Hierarchical File System of 

your Macintosh 
n Ability to define default volume and folder names 

used in compiler directives 
D Search and change features in the editor speed up 

and simplify alteration of routines 

□ Ability to use all available Macintosh memory with- 
out limit 

□ Units included to call all the routines provided by 
Macintosh Toolbox 

Suggested Retail Price: $99.95 
(not copyprotected) 

Minimum system configuration: Macintosh 512K or Macintosh Plus with one disl( 
drive. 



All Borland products are trademarks or registered trademarks of Borland International. Inc. 
Ottier brand and product names are trademarks or registered trademarks of their respective 
holders. Copyright ei987 Borland International. Inc. BOR 0167B 
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From the folks who created Turbo Pascal. Borland's new 
Turbo Pascal Tutor is everything you need to start pro- 
gramming in Turbo Pascal on the Macintosh!" It takes 

you from the bare basics to advanced programming in a 
simple, easy-tO'Understand fashion. 



No gimmicks. It's all here. 

The manual, the Tutor application, and 30 sample 
programs provide a step-by-step tutorial in three 
phases: programming in Pascal, programming on 
the Macintosh, and programming in Turbo Pascal 
on the Macintosh. Here's how the manual is set 
up:. 

Turbo Pascal for the Absolute Novice 

delivers the basics— a concise history of Pascal, 
key terminology, your first program. 

A Programmer's Guide to Turbo Pascal 

covers Pascal specifics— program structure, 
procedures and functions, arrays, strings, and so 
on. We've also included Turbo Typist, a textbook 
sample program. 

Advanced Programming 

takes you a step higher into stacks, queues, 
binary trees, linked structures, writing large pro- 
grams, and more. 



Using the Power of the Macintosh 

discusses the revolutionary hardware and soft- 
ware features of this machine. It introduces the 
600-plus utility routines in the Apple Toolbox. 

Programming the Macintosh in Turbo Pascal 

shows you how to create true Macintosh pro- 
grams that use graphics, pull-down menus, dia- 
log boxes, and so on. Finally, MacTypist, a com- 
plete stand-alone application featuring animated 
graphics, builds on Turbo Typist and demon- 
strates what you can do with all the knowledge 
you've just acquired. 

The disk contains the source code for all the 
sample programs, including Turbo Typist, MacTy- 
pist, and Turbo Tutor. The Tutor's split screen lets 
you run a procedure and view its source code 
simultaneously. After running it, you can take a 
test on the procedure. If you're stuck for an 
answer, a Hint option steers you in the right 
direction. 





Macintosh topics included are 


[^ 


memory management 


H" menus 





resources and resource files 


S" desk accessory support 


0' QuickDraw 


H* dialogs 


[^ 


events 


a* File Manager 


[^ 


windows 


H' debugging 


S 


controls 





Suggested Retail Price: $69.95 



Minimum system requirements: Any Macintosh with at least 51 2K of RAM. Requires Turbo Pascal. 



BORLAND 

INTERNA T I N A L 



Turbo Pascal and Turbo Tutor are regislered trademarks ol Borland International, Inc. Otiier brand and product names 
are trademarks or regislered trademarks ol llieir respective tralders. Copyright 1987 Borland International. BOR 0381 
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If you're a scientist, engineer, financial analyst, student, teacher, or any 

other professional working with equations. Eureka: The Solver can do 

your Algebra, Trigonometry and Calculus problems in a snap. 



Eureka also handles maximization and minimiza- 
tion problems, plots functions, generates reports, 
and saves an incredible amount of time. Even if 
you're not a computer specialist, Eurel<a can tielp 
you solve your real-vi/orld mattiematical problems 
fast, without having to learn numerical approximation 
techniques. Eureka is easy to learn and easy to 
use— as simple as a hand-held calculator. 

X + exp(X) = 10 solved instantly instead 
of eventually! 

Imagine you have to solve for X, where X -I- 
exp(X) = 10, and you don't have Eureka: The Solver. 
What you do have is a problem, because it's going 
to take a lot of time guessing at X. With Eureka, 
there's no guessing, no dancing in the dark— 
you get the right answer, right now. (PS: X = 
2.0705799, and Eureka solved that one in less than 
5 seconds!) 



Hov/ to use Eureka: The Solver 

It's easy. 

1. Enter your equation into a problem 
text window 

2. Select the "Solve" command 

3. Look at the answer 

4. You're done 

You can then tell Eureka to: 

■ Verify the solutions 

■ Draw a graph 

■ Zoom in on interesting areas of the graph 

■ Generate a report and send the output to 
your printer or disk tile 

■ Or all of the above 



Some of Eifreka's key features 

You can key in: 

S" A formula or formulas 

0' A series of equations— and solve for 

all variables 
Q' Constraints (like X must be < or = 2) 
S' Functions to plot 
Q' Unit conversions 

S' Maximization and minimization problems 
Q' Interest Rate/Present Value calculations 
Sf Variables we call "What happens?," like 

"What happens if I change this variable to 

21 and that variable to 27?" 









Eureka: The Solver includes: 

Calculator-I- desk accessory 
Powerful financial functions 
Built-in and user-defined functions 
Reports: generate and save them as 
l\/1acWrite" files— complete with graphs 
and lists— or as Text Only files 
Polynomial root finder 
Inequality constraints 

Logging: keep an up-to-the-minute record 
of your work 
l\/lacintosh" text editor 
On-screen Help system 



Suggested Retail Price: $195.00 (not copy protected) 

Minimum system configuration: Macintosh 51 2K, Macintosh Plus, SE, or II with one 800K disk drive or two 400K disk drives. 




BORLAND 

INTERNATIONAL 



Eureka: The Solver Is a trademark ol Borland International, Inc. Macintosh Is 
a trademark ol Mcintosh Laboratory, Inc. licensed to Apple Computer, Inc. 
Copyright 1987 Borland International BOR 0415 
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Turbo Pascal Numerical Methods Toolbox for the Macintosh 

implements the latest high-level mathematical methods to solve 

common scientific and engineering problems. Fast. 



So every time you need to calculate an integral, work with Fourier transforms, or incorporate any of 
the classical numerical analysis tools into your programs, you don't have to reinvent the wheel, because 
the Numerical Methods Toolbox is a complete collection of Turbo Pascal routines and programs that 
gives you applied state-of-the-art math tools. It also includes two graphics demo programs that use 
least-square and Fast Fourier Transform routines to give you the picture along with the numbers. 

The Turbo Pascal Numerical Methods Toolbox is a must if you're involved with any type of scientific or 
engineering computing on the Macintosh. Because it comes with complete source code, you have total 
control of your application at all times. 



What Numerical Methods Toolbox will do for you: 

Find solutions to equations ■ Differential equations 

Interpolations ■ Least-squares approximations 

Calculus: numerical derivatives and integrals ■ Fourier transforms 

Matrix operations: inversions, determinants, and eigenvalues ■ Graphics 



Five free ways to look at Least-Squares Fit! 

As well as a free demo of Fast Fourier Transforms, you also get the Least-Squares Fit in 
five different forms— which gives you five different methods of fitting curves to a collection 
of data points. You instantly get the picture! The five different forms are 


I.Power 4. 5-term Fourier 

2. Exponential 5. 5-term 

3. Logarithm Poynomial 


They're all ready to compile and run as is. 



Suggested Retail Price: $99.95 (not copyprotected) 

Minimum system requirements: Macintosh 512K, Macintosh Plus, SE, or II, with one 800K disk drive (or two 400K). 




BORLAND 



All Bocland picducts are trademarks or registered trademarks of Borland Intennational, 
Inc. or Borland/Analytica, Inc. Macintosh is a trademark licensed to Apple Computer, 
INTERNA T I N A L Inc. Copyright 1987 Borland International. A Borland to) roo/to produa 

B0R0419 



foSand 

OBDBR T0OA7 





BORLAND 



INTERNATIONAL 



4585 Scotts Valley Drive Scotts Valley, California 95066 



To Order 




In 



By Credit i \ ^""'f' 






^^gfl \i^ (800) 

(800) 
255-8008 ■ '" '^™^* "^'i 




742-1133 



(800) 237-1138 



eOR02, 



PRoaucmjY 



umn, 



RAM-resident 

Increased productivity 
for IBM^PCs or 
1^ compatibles 



S 



uperKey's simple macros are electronic shortcuts to success. 
By letting you reduce a lengthy paragraph into a single keystroke 
of your choice, SuperKey eliminates repetition. 



SuperKey turns 1,000 keystrokes 
into 1! 

SuperKey can record lengthy 
keystroke sequences and play them 
back at the touch of a single key. 
Instantly. Like magic. 

In tact, with SuperKey's simple 
macros, you can turn "Dear Customer: 
Thank you for your inquiry. We are 
pleased to let you know that shipment 
will be made within 24 hours. Sin- 
cerely," into ttie one keystroke of 
your choice! 



SuperKey keeps your confidential 
files— confidential! 

Without encryption, your files are 
open secrets. Anyone can walk up to 
your PC and read your confidential 
files (tax returns, business plans, 
customer lists, personal letters, etc.). 

With SuperKey you can encrypt any 
file, even while running another pro- 
gram. As long as you keep the pass- 
word secret, only you can decode 
your file correctly. SuperKey also 
implements the tJ.S. government 
Data Encryption Standard (PES). 



Bf RAM resident— accepts new 
macro files even while running 
other programs 
^ Pull-down menus 
gf Superfast file encryption 
0' Choice of two encryption 
schemes 

On-line context-sensitive help 
One-finger mode reduces key 
commands to single keystroke 
Screen OFF/ON blanks out 
and restores screen to protect 
against "burn in" 
Partial or complete 
reorganization of keyboard 



Si 
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^ Keyboard buffer increases 16 

character keyboard "type-ahead" 

buffer to 128 characters 
0' Real-time delay causes macro 

playback to pause for specified 

interval 
0' Transparent display macros allow 

creation of menus on top of 

application programs 
Data entry and format control 

using "fixed" or "variable" fields 
si Command stack recalls last 256 

characters entered 



IBMltERSm 

PC, XT*Ar& True Compatibles 



Minimum system configuration: IBM PC, XT. AT, PCjr, and true compatibles. PC- DOS (MS-DOS) 
2.0 or greater. 128K RAM. One disk drive. 

SuperKey is a registered Irademark ol Borland Internalional, Inc. IBM, XT, AT, and PCjr are registered trademarks ol 
Inlernational Business Machines Corp MS-DOS is a regislered trademark ol Microsoft Corp bor 0294A 
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